API reference

Flights

Search, re-price the offer you picked, book it. Both search and re-pricing are billable; a booking is charged to your account.

Operations

Operation	What it does	Scope
POST/v1/flights/searches	Search flights — billable, answers immediately	`flights:search`
GET/v1/flights/offers/{id}	Re-price an offer — billable	`flights:search`
GET/v1/flights/orders	Your flight orders, newest first	`flights:book`
POST/v1/flights/orders	Book an offer — charged to your account	`flights:book`
GET/v1/flights/orders/{id}	One order	`flights:book`
GET/v1/flights/orders/{id}/cancellation-quote	What cancelling would cost	`flights:book`
POST/v1/flights/orders/{id}/cancel	Cancel a flight order	`flights:book`
POST/v1/flights/orders/{id}/change-options	Priced alternatives for one leg	`flights:book`
POST/v1/flights/orders/{id}/change	Reissue the ticket on a chosen option	`flights:book`

A key that lacks one of these scopes is refused with 403 insufficient_scope, and error.missingScope names the one it was missing. Scopes are fixed when the key is issued.

Shared across these operations

The error envelope and the full list of error types are the same for every operation in the API, as are the object schemas the responses are built from. Neither is repeated per page.