> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tickable.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Availability

> Show the places left on your own website

`GET /events/{id}/availability` returns every timeslot that is not over yet, earliest first, with the places left per ticket type. The numbers are calculated exactly like the shop does: cancelled tickets free their place and test orders take none.

```bash theme={null}
curl "https://api.tickable.io/events/550e8400-e29b-41d4-a716-446655440000/availability" \
  -H "Authorization: Bearer tk_live_YOUR_API_KEY"
```

```json theme={null}
{
  "data": [
    {
      "timeslot_id": "d4e5f6a7-8901-4b2c-3d4e-5f6a7b8c9d0e",
      "title": "Morning Session",
      "starts_at": "2026-06-15T10:00:00Z",
      "ends_at": "2026-06-15T12:00:00Z",
      "total_available": 200,
      "remaining": 37,
      "sale_closes_at": "2026-06-15T12:00:00Z",
      "on_sale": true,
      "ticket_types": [
        {
          "ticket_type_id": "b2c4e6a8-1234-4f5a-9c8d-0e1f2a3b4c5d",
          "name": "Early Bird",
          "price": 2500,
          "visibility": "visible",
          "remaining": 12,
          "sold_out": false,
          "on_sale": true,
          "sale_opens_at": null,
          "sale_closes_at": "2026-06-08T10:00:00Z"
        }
      ]
    }
  ],
  "pagination": { "total": 1, "limit": 25, "offset": 0, "has_more": false }
}
```

* `remaining` is the tightest limit that applies: the ticket type's own, its group's or the timeslot's. `null` means there is no limit.
* `on_sale` tells you whether a visitor can buy it online right now. Use it to decide between a "Buy tickets" button and "Sold out" or "Sale starts soon".
* The shop can hide the exact count until only a few places are left; the API always returns the real number, so decide yourself what to show.
* Pass `from` and `until` to pick a date range, including timeslots in the past.

> [!TIP]
>
> Availability changes with every order. Fetching it once a minute is plenty for a website; cache the response on your server rather than calling the API from every visitor's browser, which would also expose your API key.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.