# BetterTickets API > Read your BetterTickets events, ticket types and live availability, and look up and upsert Custom List rows, from your own server. REST over HTTPS with JSON, Bearer API keys (`btk_live_` / `btk_test_`), base URL `https://app.bettertickets.com/api/partner/v1`. Server-to-server only (no CORS). Every page below is plain Markdown. Ask your BetterTickets contact for an API key. ## Guides - [Introduction](https://docs.bettertickets.com/index.md): Read your BetterTickets events, ticket types and live availability, and keep your Custom Lists in sync, from your own server. - [Authentication & Keys](https://docs.bettertickets.com/authentication.md): Bearer API keys, scopes, account access, and keeping keys safe. - [Test vs Live](https://docs.bettertickets.com/test-vs-live.md): How btk_test_ and btk_live_ keys differ. - [Errors](https://docs.bettertickets.com/errors.md): The error shape, every error code, and which errors are safe to retry. - [Rate Limits](https://docs.bettertickets.com/rate-limits.md): Request limits per key and per IP address, the 429 response, and how to back off. - [Pagination](https://docs.bettertickets.com/pagination.md): Page through GET /events with page and per_page. - [Custom Lists](https://docs.bettertickets.com/custom-lists.md): Look up and upsert Custom List rows from your server. - [Changelog](https://docs.bettertickets.com/changelog.md): Changes to the BetterTickets API and these docs. ## API Reference - [Events](https://docs.bettertickets.com/reference/events.md): Your account's events and their ticket types. Read-only. - [GET /events — List events](https://docs.bettertickets.com/reference/list-events.md): Lists your account's events that are active, on sale, not test events, and have a title and start time, sorted by date (earliest first). - [GET /events/{id} — Get one event](https://docs.bettertickets.com/reference/get-event.md): One event of your account, by numeric id or concert_sku. - [GET /events/{id}/locations — List an event's ticket types](https://docs.bettertickets.com/reference/list-event-locations.md): The active ticket types of one event, in display order, with prices in cents and live availability. - [Availability](https://docs.bettertickets.com/reference/availability.md): Live availability of a ticket type. Read-only; nothing is reserved. - [GET /locations/{id}/availability — Get live availability of a ticket type](https://docs.bettertickets.com/reference/get-location-availability.md): Tickets left for one ticket type. - [Custom Lists](https://docs.bettertickets.com/reference/custom-lists.md): Read and add or update rows of your Custom Lists. Needs Custom Lists on your account and API Access on the list. - [GET /lists/{id}/rows — Look up one list row by key](https://docs.bettertickets.com/reference/lookup-list-row.md): Finds the row whose key column equals key. - [POST /lists/{id}/rows — Add or update list rows](https://docs.bettertickets.com/reference/upsert-list-rows.md): Adds or updates 1–500 rows by the list's key column. ## Optional - [OpenAPI 3.1 spec](https://docs.bettertickets.com/openapi.json): Machine-readable spec of every operation above. - [Full documentation](https://docs.bettertickets.com/llms-full.txt): Every page above in one Markdown file.