Skip to main content

AirportSearchRequest

Airport transfer search: between an airport and a hotel or address. transfer_type may be omitted.

transfer_typestring

airport or omitted.

Possible values: [airport]

Default value: airport
Example: airport
iatastringrequired

Airport IATA code, upper case, for example BOM.

Possible values: >= 3 characters and <= 3 characters

Example: BOM
airport_namestring | nullnullable

Airport display name. Optional; shown in booking details when the provider does not return it.

Example: Chhatrapati Shivaji Maharaj International Airport
source_typeSourceTyperequired

air: the transfer starts at the airport (arrival leg). hotel or geo: the transfer starts at place (departure leg).

Possible values: [air, hotel, geo]

Example: air
place objectrequired

The hotel or address end of the transfer.

latnumberrequired

Latitude.

Example: 18.9217
lngnumberrequired

Longitude.

Example: 72.8332
addressstring | nullnullable

Address. Recommended.

Example: Apollo Bunder, Colaba, Mumbai 400001
namestring | nullnullable

Place name, for example the hotel name.

Example: The Taj Mahal Palace
arrival_datestringrequired

Pickup date of the arrival leg, YYYY-MM-DD, local to the airport. Not format-checked by the API: send exactly this format.

Example: 2026-11-26
arrival_timestringrequired

Pickup time of the arrival leg, HH:MM (24 h), local. Not format-checked by the API: send exactly this format.

Example: 10:30
departure_datestring | nullnullable

Pickup date of the departure leg, YYYY-MM-DD. Send with departure_time. When only arrival_* is set and source_type is hotel/geo, the departure leg uses arrival_*.

Example: 2026-11-30
departure_timestring | nullnullable

Pickup time of the departure leg, HH:MM (24 h), local.

Example: 06:00
adultsinteger

Adults (and children who need a full seat).

Possible values: >= 1

Default value: 1
Example: 2
childreninteger

Children.

Possible values: >= 0

Default value: 0
Example: 0
infantsinteger

Infants.

Possible values: >= 0

Default value: 0
Example: 0
currencystring

Requested currency, ISO 4217 (for example INR, USD, EUR). Every price in the response is in this currency. An unsupported code answers 422 unsupported_currency.

Possible values: >= 3 characters and <= 3 characters

Default value: USD
Example: INR
flight_info object

Not used at search; send flight details at book.

anyOf

Flight details at search time. Accepted but not used today; send flight details at book.

airlinestring | nullnullable

IATA airline code.

Example: AI
flight_numberstring | nullnullable

Flight number.

Example: AI101
flight_typestring | nullnullable

domestic or international.

Example: international
providersProviderCode[]nullable

Restrict the search to these providers. Default: all providers enabled for your key.

Possible values: Value must match regular expression ^[a-z0-9_]+$

Example: ["provider_a","provider_b"]
metadata object

Free-form. Not used today.

property name*any

Free-form. Not used today.

Example: {}
AirportSearchRequest
{
  "transfer_type": "airport",
  "iata": "BOM",
  "airport_name": "Chhatrapati Shivaji Maharaj International Airport",
  "source_type": "air",
  "place": {
    "lat": 18.9217,
    "lng": 72.8332,
    "name": "The Taj Mahal Palace",
    "address": "Apollo Bunder, Colaba, Mumbai 400001"
  },
  "arrival_date": "2026-11-26",
  "arrival_time": "10:30",
  "departure_date": "2026-11-30",
  "departure_time": "06:00",
  "adults": 2,
  "children": 0,
  "infants": 0,
  "currency": "INR",
  "flight_info": {
    "airline": "AI",
    "flight_number": "AI101",
    "flight_type": "international"
  },
  "providers": [
    "provider_a",
    "provider_b"
  ],
  "metadata": {}
}