# QuickOTA Developer API

> REST API for travel agencies on QuickOTA: search, book, ticket and service flights from your own software. Base URL https://quickota.com/api/v1 (keys tam_live_…).

For everything in one file (guides, full endpoint reference, all error codes) read https://quickota.com/developers/llms-full.txt

## Get started

- [Overview](https://quickota.com/developers/guides/overview.md): What the QuickOTA API does, the base URL, and the conventions every endpoint follows.
- [Quick start](https://quickota.com/developers/guides/quick-start.md): Search, hold and ticket your first flight in ten minutes.
- [Authentication](https://quickota.com/developers/guides/environments-and-authentication.md): API keys, scopes, IP allow-lists and key rotation.

## Flights

- [Booking flow](https://quickota.com/developers/guides/booking-flow.md): The full flight flow step by step — search, price, fare rules, hold, issue, cancel — and what can go wrong at each step.
- [Managing booking states](https://quickota.com/developers/guides/managing-booking-states.md): Every booking status, what to do in each, how to handle pending and asynchronous states, deadlines and your work queue.
- [Refunds, changes & schedule changes](https://quickota.com/developers/guides/servicing-and-schedule-changes.md): Refund, void or change a ticketed booking through quoted servicing requests, and answer airline schedule changes.

## Essentials

- [Errors](https://quickota.com/developers/guides/errors.md): How errors are reported, how to handle them, and the complete list of error codes.
- [Idempotency](https://quickota.com/developers/guides/idempotency.md): Retry writes safely with the Idempotency-Key header — never book or ticket twice.
- [Rate limits & look-to-book](https://quickota.com/developers/guides/rate-limits-and-look-to-book.md): Request rate limits, daily and monthly search quotas, and the look-to-book ratio.
- [Webhooks](https://quickota.com/developers/guides/webhooks.md): Receive signed notifications when bookings change, instead of polling.

## Reference

- [Changelog](https://quickota.com/developers/guides/changelog.md): What changed in the API, newest first.

## Reference

- [OpenAPI 3 document](https://quickota.com/developers/openapi.json): every endpoint and schema, for code generators
- [Endpoint reference](https://quickota.com/developers/reference.md): every endpoint with request and response examples
- [Error codes](https://quickota.com/developers/errors.md): every error code, when it happens and what to do
- [Error codes as JSON](https://quickota.com/developers/errors.json)