API reference

Hotels

Resolve a destination, search, read the rates of one hotel, book. Searching is billable; a booking is charged to your account.

Operations

Operation	What it does	Scope
GET/v1/hotels/destinations	Resolve a place name to something searchable	`hotels:search`
POST/v1/hotels/searches	Start a search — billable	`hotels:search`
GET/v1/hotels/searches/{id}	Current state of a search — free	`hotels:search`
PATCH/v1/hotels/searches/{id}	Refine a search — billable only if it reaches the supplier	`hotels:search`
POST/v1/hotels/searches/{id}/load-more	Fetch more results — billable	`hotels:search`
GET/v1/hotels/{hotelId}/rates	The bookable rates of one hotel — billable	`hotels:search`
GET/v1/hotels/bookings	Your hotel bookings, newest first	`hotels:book`
POST/v1/hotels/bookings	Book a rate — charged to your account	`hotels:book`
GET/v1/hotels/bookings/{id}	One booking	`hotels:book`
POST/v1/hotels/bookings/{id}/cancel	Cancel a booking	`hotels: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.