# Highstar Travel API

> REST API to search, quote, book and cancel travel products. Guides in Markdown and OpenAPI specifications.

## API v2

### Getting started

- [Overview](/developers/guides/v2-overview.md): One booking flow for every product, with signed offers and a closed error catalog.
- [Authentication](/developers/guides/authentication.md): Send your credential as a Bearer token and know what each 401 and 403 means.
- [Sandbox](/developers/guides/sandbox.md): How test credentials behave on each product.

### Booking flow

- [Booking flow](/developers/guides/v2-booking-flow.md): The steps every product shares: offer, check, booking, reading, cancellation, voucher and errors.

### Products

- [Transfers](/developers/guides/v2-transfers.md): What is specific to transfers: catalog, trip logistics and the daily price calendar.
- [Tickets](/developers/guides/v2-tickets.md): What is specific to Universal and Disney tickets: brand filter, categories, time slots, partial results, price sources and named travelers.
- [Hotels](/developers/guides/v2-hotels.md): What is specific to hotels: destinations and content, asynchronous search, offers per room, Disney resort hotels, several rooms and the hotel confirmation number.

### Fundamentals

- [Conventions](/developers/guides/conventions.md): Formats, request_id, rate limits, timeouts, retries and idempotency.
- [Errors](/developers/guides/v2-errors.md): Every v2 error code with its HTTP status and what to do about it.

### Resources

- [Migrating from v1](/developers/guides/v2-migrating-from-v1.md): How the Transfers, Hotels, Universal and Disney v1 calls map to v2. v1 stays available.
- [Changelog](/developers/guides/changelog.md): Dated changes to the public API.
- [Support](/developers/guides/support.md): How to get credentials and what to send when you report a problem.

## API v1

### Getting started

- [Introduction](/developers/guides/introduction.md): What the API covers and how a sale moves through it.
- [Quickstart](/developers/guides/quickstart.md): Your first sandbox booking, from catalog to cancellation.

### Fundamentals

- [Errors](/developers/guides/errors.md): The error envelope, HTTP status codes and how to react to each.

### Products

- [Transfers](/developers/guides/transfers.md): Catalog, daily price calendar, booking with a lead traveler, cancellation and voucher.
- [Hotels](/developers/guides/hotels.md): Search with polling, price check, booking, cancellation and hotel confirmation number.
- [Universal](/developers/guides/universal.md): Universal Orlando tickets: catalog, prices per date, booking and voucher.
- [Disney](/developers/guides/disney.md): Walt Disney World and Disneyland Resort tickets by product code.

## API reference

- [API v1 OpenAPI, all products](/developers/openapi/v1.json): OpenAPI 3.1 specification with every v1 product in one document.
- [Transfer v1 OpenAPI](/developers/openapi/v1/transfer.json): OpenAPI 3.1 specification of the transfer endpoints.
- [Hotel v1 OpenAPI](/developers/openapi/v1/hotel.json): OpenAPI 3.1 specification of the hotel endpoints.
- [Universal v1 OpenAPI](/developers/openapi/v1/universal.json): OpenAPI 3.1 specification of the universal endpoints.
- [Disney v1 OpenAPI](/developers/openapi/v1/disney.json): OpenAPI 3.1 specification of the disney endpoints.
- [API v2 OpenAPI, all products](/developers/openapi/v2.json): OpenAPI 3.1 specification with every v2 product in one document.
- [Transfers v2 OpenAPI](/developers/openapi/v2/transfers.json): OpenAPI 3.1 specification of the transfers endpoints.
- [Tickets v2 OpenAPI](/developers/openapi/v2/tickets.json): OpenAPI 3.1 specification of the tickets endpoints.
- [Hotels v2 OpenAPI](/developers/openapi/v2/hotels.json): OpenAPI 3.1 specification of the hotels endpoints.
- [Bookings v2 OpenAPI](/developers/openapi/v2/bookings.json): OpenAPI 3.1 specification of the bookings endpoints.

## Optional

- [All guides in one file](/developers/llms-full.txt): the text of every guide, grouped by API version.