# Eventory API

> Live ticket availability, real-time notifications, market data and watchlists for the major ticketing platforms.

- [Introduction](https://docs.eventory.ai/index.md): Live ticket availability, real-time notifications, market data and watchlists for the major ticketing platforms, behind one API key.
- [Quickstart](https://docs.eventory.ai/quickstart.md): Verify your key, add an event to your watchlist, and pull live availability in five minutes.
- [Authentication](https://docs.eventory.ai/authentication.md): One API key, sent in the apikey header, for every API.
- [Credits & access](https://docs.eventory.ai/credits-and-access.md): What each endpoint costs, which APIs your key can call, and where to see your balance.
- [Rate limits](https://docs.eventory.ai/rate-limits.md): 30 requests per minute per account, enforced before billing.
- [Errors](https://docs.eventory.ai/errors.md): Every error code the API can return, what it actually means, and what to do.
- [Stream overview](https://docs.eventory.ai/stream/overview.md): A WebSocket that pushes a notification whenever an event on your watchlist changes.
- [Connecting](https://docs.eventory.ai/stream/connecting.md): Open the WebSocket, handle the handshake errors, and reconnect safely.
- [Message format](https://docs.eventory.ai/stream/messages.md): The notification envelope, the changes map, and the two section shapes.
- [Section types](https://docs.eventory.ai/guides/section-types.md): The two shapes of sections returned by the stream and the Live Availability API.
- [Search filters](https://docs.eventory.ai/guides/search-filters.md): The filterExpression syntax for POST /eventory/data/search and the attributes you can filter on.
- [Supported platforms](https://docs.eventory.ai/guides/platforms.md): The platforms Live Availability can scrape, the regions each accepts, and what to pass as event_id.
- [API reference](https://docs.eventory.ai/reference/introduction.md): Base URL, conventions, and a map of every HTTP endpoint.
- [Search events](https://docs.eventory.ai/api-reference/market-data/search-events.md): Full-text search across the Eventory event catalog with optional filters and sort orders. See the **Search filters** guide for the `filterExpression` syntax and the filterable attributes.
- [Viagogo event](https://docs.eventory.ai/api-reference/market-data/viagogo-event.md): Returns Viagogo event metadata, the latest aggregate summary, a rolling daily statistics history, and a price distribution histogram.
- [Viagogo recent sales](https://docs.eventory.ai/api-reference/market-data/viagogo-recent-sales.md): Returns the most recent individual Viagogo sales for an event, newest first.
- [Ticketmaster event](https://docs.eventory.ai/api-reference/market-data/ticketmaster-event.md): Returns Ticketmaster event data (scrape runs, per-section and per-offer snapshot stats, statistics history), the latest aggregate stats, and the dashboard chart payload. The three blocks are fetched in parallel.
- [Artist](https://docs.eventory.ai/api-reference/market-data/artist.md): Resolves an artist by its exact marketplace URL and returns social metrics, the latest snapshot, and a rolling window of platform snapshots.
- [Add event to tracking](https://docs.eventory.ai/api-reference/market-data/add-event-to-tracking.md): Registers an event so that Eventory starts collecting market data for it. Supply exactly one source: a Viagogo pair (`event_url` + `viagogo_event_id`) or a Ticketmaster pair (`ticketmaster_event_url` + `ticketmaster_event_id`).
- [Ping](https://docs.eventory.ai/api-reference/market-data/ping.md): Liveness probe for the Market Data API.
- [List platforms](https://docs.eventory.ai/api-reference/live-availability/list-platforms.md): Returns the eleven supported platform keys with their accepted regions, the shape of the `sections` they return, and an example event id. Use it to confirm the exact `platform` and `event_id` format before calling `POST /events/scrape`. Several platforms take the full event URL as `event_id`.
- [Scrape live availability](https://docs.eventory.ai/api-reference/live-availability/scrape-live-availability.md): Fetches the current ticket availability for a single event on one of the supported platforms (see `GET /events/platforms`). The scrape runs synchronously and can take up to 60 seconds; set your client timeout to at least 65 seconds.
- [Ping](https://docs.eventory.ai/api-reference/live-availability/ping.md): Liveness probe for the Live Availability API.
- [List watchlist items](https://docs.eventory.ai/api-reference/watchlist/list-watchlist-items.md): Returns every watchlist item owned by your account. Empty array if you have none.
- [Create watchlist item](https://docs.eventory.ai/api-reference/watchlist/create-watchlist-item.md): Creates a watchlist item. `website`, `event`, and `region` are required; every other field is optional and takes the server default when omitted. Sending an explicit `null` stores `NULL`.
- [Get watchlist item](https://docs.eventory.ai/api-reference/watchlist/get-watchlist-item.md): Returns a single item by id.
- [Update watchlist item](https://docs.eventory.ai/api-reference/watchlist/update-watchlist-item.md): Partial update. Send only the fields you want to change; omitted fields are left untouched. To clear a nullable field, send it explicitly as `null`.
- [Delete watchlist item](https://docs.eventory.ai/api-reference/watchlist/delete-watchlist-item.md): Deletes an item. The stream stops delivering notifications for it within 60 seconds.
- [Health](https://docs.eventory.ai/api-reference/watchlist/health.md): Liveness probe for the Watchlist API. Authentication is required like any other call.
- [Usage](https://docs.eventory.ai/api-reference/account/usage.md): Returns your plan, billing period, and credit usage, fetched live from billing on every call. Any valid key may call this endpoint, whatever routes it is granted, so it is also the safest way to test a key.

## OpenAPI Specs

- [openapi](/openapi.yaml)