Search transfer offers

POST 
/v1/search

Searches all providers enabled for your key (or the providers you name) in parallel and returns their offers. The body shape is chosen by transfer_type: omitted or airport → AirportSearchRequest; point_to_point or intercity → PointToPointSearchRequest; hourly → HourlySearchRequest.

Each provider has 30 seconds to answer. Provider failures do not fail the search: they are listed in errors[] and the other offers are returned. Every price is in the requested currency; an unsupported code answers 422 unsupported_currency.

Guides: Transfer types, Currency.

Request

Responses

200

OK

Response Headers

X-Request-Id

Id of this request (yours if you sent a valid one). Quote it to support.

401

Missing or invalid API key (unauthorized). Header WWW-Authenticate: ApiKey header="X-API-Key".

Response Headers

WWW-Authenticate

ApiKey header="X-API-Key"

413

Request body larger than 256 KB (payload_too_large).

Response Headers

X-Request-Id

Id of this request (yours if you sent a valid one). Quote it to support.

422

Invalid request body (validation_error), or an unsupported currency (unsupported_currency).

Response Headers

X-Request-Id

Id of this request (yours if you sent a valid one). Quote it to support.

429

Rate limit exceeded for this API key (rate_limited). Wait Retry-After seconds.

Response Headers

X-Request-Id

Id of this request (yours if you sent a valid one). Quote it to support.

Retry-After

Seconds to wait before retrying.

500

Unexpected error (internal_error); no details are returned. Report it with the request_id.

Response Headers

X-Request-Id

Id of this request (yours if you sent a valid one). Quote it to support.

503

Authentication or booking records temporarily unavailable (auth_unavailable, service_unavailable). Nothing reached a provider. Retry with backoff.

Response Headers

X-Request-Id

Id of this request (yours if you sent a valid one). Quote it to support.