Availability

Fetch Availability For An Event

Changed on

This endpoint returns a URL to Tickitto's Ticket Selection Widget for the event being searched.

The Widgets are availability aware and load in real-time what seats, dates, and times are available to be selected for that event.

Any additional selection required for add ons, pickup points, or concessions will be displayed in the Widget.

You will need to pass the event_id and a basket_id with this endpoint. To generate a basket_id, you will need to first create a basket by making a POST request to the create basket endpoint.

When the ticket buyer selects a ticket via the Widget, they will then need to invoke the 'add to basket' action. This action will add the chosen ticket(s) to the basket_id associated with that widget URL.

get/api/availability/

Request

  • Base URL
    https://tickitto.tech (the document declares no server; this is the origin it was published from)
  • URL
    https://tickitto.tech/api/availability/
  • Auth
    API key in header key

Query parameters

event_idstring required
basket_idstring

REQUIRED FOR A VALID BOOKING FLOW. The ID of the basket associated with the current session. Only optional if you do not intend to add tickets to a basket using this availability session.

allow_cacheboolean

If true, allows reusing results which are up to 300.0 seconds old.The session is returned much faster but may contain old availabilities.

t1string date

Inclusive start of the date range from which to fetch initial availabilities.

t2string date

Inclusive end of the date range from which to fetch initial availabilities.

profile_namestring

Profile name

hostnamestring

Associated hostname

Headers

originstring
X-Correlation-IDstring

Optional transaction reference provided by the client. Used to correlate API requests and responses with client flow in logs, errors etc.

Response

Successful Response

session_idstring required

Machine identifier of this session

view_urlstring required

URL where the widget can be used to book this session

Changes

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status