> ## 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.

# Introduction

> Get started with the Tickable API

The Tickable API gives you programmatic access to your events, tickets, orders, and webhooks. Use it to build custom integrations, sync data with your systems, or automate workflows.

## Base URL

All API requests are made to:

```
https://api.tickable.io
```

## Authentication

Every request must include a valid token in the `Authorization` header:

```
Authorization: Bearer {token}
```

You can authenticate with either:

* **API Key** — created from the [Tickable dashboard](https://app.tickable.nl/settings/developers). Best for server-to-server integrations.
* **OAuth2 access token** — obtained via the OAuth2 flow. Best for third-party apps acting on behalf of a user.

<Card title="Authentication Guide" icon="lock" href="/authentication">
  Learn how to authenticate your requests
</Card>

## Key Concepts

<CardGroup cols={2}>
  <Card title="Events" icon="calendar" href="/api-reference/events/list-events">
    Events are the core resource. Each event has ticket types and timeslots.
  </Card>

  <Card title="Orders" icon="receipt" href="/api-reference/orders/list-orders">
    Orders represent purchases. Each order contains order lines linked to ticket types.
  </Card>

  <Card title="Tickets" icon="ticket" href="/api-reference/tickets/list-tickets">
    Retrieve tickets for an event, filter by order, and check scan/cancel status.
  </Card>

  <Card title="Timeslots" icon="clock" href="/api-reference/events/list-timeslots">
    Timeslots represent when an event takes place. An event can have one or many.
  </Card>

  <Card title="Webhooks" icon="bell" href="/api-reference/webhooks/create-webhook">
    Get notified in real-time when orders are placed or tickets are scanned.
  </Card>
</CardGroup>

## Response Format

All list endpoints return paginated responses:

```json theme={null}
{
  "data": [...],
  "pagination": {
    "total": 142,
    "limit": 25,
    "offset": 0,
    "has_more": true
  }
}
```

## Need Help?

If you have questions or run into issues, reach out to us at [tickable.nl](https://tickable.nl).