---
title: "Fetch Availability For An Event"
method: GET
path: "/api/availability/"
tags: ["Availability"]
---

# Fetch Availability For An Event

`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`

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.

## Query parameters

- `event_id` string, required
- `basket_id` string: 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_cache` boolean: If true, allows reusing results which are up to 300.0 seconds old.The session is returned much faster but may contain old availabilities.
- `t1` string, date: Inclusive start of the date range from which to fetch initial availabilities.
- `t2` string, date: Inclusive end of the date range from which to fetch initial availabilities.
- `profile_name` string: Profile name
- `hostname` string: Associated hostname

## Headers

- `origin` string
- `X-Correlation-ID` string

## Response `200`

Successful Response

- SessionObject
  - `session_id` string, required: Machine identifier of this session
  - `view_url` string, required: URL where the widget can be used to book this session

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `409`: Conflict
- `410`: Gone
- `422`: Validation Error
- `500`: Internal Server Error

## Changes

- **2026-09-08** `71035d272191`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Operation history](https://skmtc.dev/tickitto/apis/tickitto-api/changes/api/availability/get.md)

---

[API](https://skmtc.dev/tickitto/apis/tickitto-api.md) - [All operations](https://skmtc.dev/tickitto/apis/tickitto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tickitto/apis/tickitto-api/revisions/22e674e2f052?raw)