# Tickable API

## Docs

- [Get Event](https://docs.tickable.io/api-reference/events/get-event.md): Retrieve a single event with its ticket types. If the event has exactly one timeslot, it is included as `timeslot`. Requires the `events.read` scope.
- [List Events](https://docs.tickable.io/api-reference/events/list-events.md): List all events for your organization. Requires the `events.read` scope.
- [List Timeslots](https://docs.tickable.io/api-reference/events/list-timeslots.md): List timeslots for an event. Filter by date range using `from` and `until`. Requires the `events.read` scope.
- [Authorize](https://docs.tickable.io/api-reference/oauth/authorize.md): Start the OAuth2 authorization code flow. Redirects back to `redirect_uri` with a `code` and `state` parameter.
- [Token](https://docs.tickable.io/api-reference/oauth/token.md): Exchange an authorization code, client credentials, or refresh token for an access token.
- [Get order](https://docs.tickable.io/api-reference/orders/get-order.md): Retrieve a single order with its order lines. Requires the `orders.read` scope.
- [List orders](https://docs.tickable.io/api-reference/orders/list-orders.md): List all orders for your organization. Optionally filter by `event_id`. Requires the `orders.read` scope.
- [List Tickets](https://docs.tickable.io/api-reference/tickets/list-tickets.md): List all tickets for an event. Optionally filter by `order_id`. Requires the `tickets.read` scope.
- [Scan Ticket](https://docs.tickable.io/api-reference/tickets/scan-ticket.md): Scan a ticket using a scanner registered to your organization. If `scanner_id` is omitted, the first active scanner in your organization is used. The scanner's profile rules, timeslot restrictions, and scan windows are enforced automatically. Requires the `tickets.write` scope.
- [Get current user](https://docs.tickable.io/api-reference/user/get-current-user.md): Returns the authenticated user's ID, email, and organization name.
- [Create Webhook](https://docs.tickable.io/api-reference/webhooks/create-webhook.md): Register a new webhook endpoint to receive event notifications. Requires the `webhooks.write` scope.
- [Delete Webhook](https://docs.tickable.io/api-reference/webhooks/delete-webhook.md): Remove a webhook subscription. Requires the `webhooks.write` scope.
- [List Webhooks](https://docs.tickable.io/api-reference/webhooks/list-webhooks.md): List all webhook subscriptions for your organization. Requires the `webhooks.read` scope.
- [Authentication](https://docs.tickable.io/authentication.md): How to authenticate with the Tickable API
- [Pagination](https://docs.tickable.io/guides/pagination.md): How to paginate through list endpoints
- [Tickets](https://docs.tickable.io/guides/tickets.md): List tickets for an event and scan them via the API
- [Webhooks](https://docs.tickable.io/guides/webhooks.md): Receive real-time notifications for events in your organization
- [Introduction](https://docs.tickable.io/introduction.md): Get started with the Tickable API
- [Quickstart](https://docs.tickable.io/quickstart.md): Make your first API call in under 2 minutes

## OpenAPI Specs

- [doc](https://api.tickable.io/doc)
- [openapi](https://docs.tickable.io/api-reference/openapi.json)