Skip to main content
GET
Ways to book one itinerary
Use a one-way itinerary ID or a selected return option ID. Keep the route, dates, country, and currency consistent with the search that produced it. Give the returned booking link to the person completing the purchase. Retrieving options does not reserve or buy a ticket. Links expire after one day; check expires_at and request fresh options when needed.

Authorizations

Authorization
string
header
required

Public API key: Authorization: Bearer san_....

Path Parameters

id
string
required

The id of a one-way itinerary or of a return option.

Example:

"san1.QkFEQ0FGRTAxMjM0NTY3ODk"

Query Parameters

country
string

ISO 3166-1 alpha-2. Defaults to us.

Example:

"us"

currency
string

ISO 4217. Defaults to the currency of country.

Example:

"USD"

return_date
string

Required when the id came from a round trip.

Example:

"2026-10-19"

departure_date
string
required
Example:

"2026-10-15"

to
string
required
Example:

"NRT"

from
string
required
Example:

"SIN"

Response

id
string<uuid>
required

Id of this request. Quote it when reporting a problem.

took_ms
number
required

How long the request took, in milliseconds.

Example:

1420

request
object
required

The parameters as accepted, after defaults and normalization. What the request actually ran with.

Example:
bookings
object[]
required

Ways to buy this itinerary, best first.