PointToPointSearchRequest

Point-to-point transfer search between two addresses (one way or round trip). Unknown fields are rejected. intercity is accepted as an alias of point_to_point.

pickup objectrequired

Pickup location.

latnumberrequired

Latitude, -90 to 90.

Possible values: >= -90 and <= 90

Example: 18.9217

lngnumberrequired

Longitude, -180 to 180.

Possible values: >= -180 and <= 180

Example: 72.8332

addressstringrequired

Full address, at least 3 characters.

Possible values: >= 3 characters

Example: Apollo Bunder, Colaba, Mumbai 400001

namestring | nullnullable

Place name, for example a hotel or station.

Example: The Taj Mahal Palace

citystring | nullnullable

City. Recommended: some providers need it to find the city they serve.

Example: Mumbai

country_codestring | nullnullable

ISO 3166-1 alpha-2, upper case. Recommended: providers limited to one country are skipped when the pickup is elsewhere.

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

Example: IN

tp_location_idstring | nullnullable

Location id agreed with Pathfndr, when you have one.

Possible values: <= 64 characters

Example: null

pickup_datestringrequired

Pickup date, YYYY-MM-DD, local to the pickup.

Example: 2026-11-27

pickup_timestringrequired

Pickup time, HH:MM (24 h), local to the pickup.

Example: 09:00

adultsinteger

Adults. Adults + children + infants: at most 16.

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

luggageinteger | nullnullable

Number of suitcases. Used by providers that price by luggage. Default: one per adult.

Possible values: >= 0 and <= 20

Example: 2

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

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: {}

transfer_typestring

point_to_point (or the alias intercity). Required: without it the body is read as an airport search.

Possible values: [point_to_point, intercity]

Default value: point_to_point

Example: point_to_point

trip_typestring

one_way, or round_trip (requires return_date and return_time).

Possible values: [one_way, round_trip]

Default value: one_way

Example: round_trip

dropoff objectrequired

Drop-off location, at least 1 km from the pickup.

latnumberrequired

Latitude, -90 to 90.

Possible values: >= -90 and <= 90

Example: 18.9217

lngnumberrequired

Longitude, -180 to 180.

Possible values: >= -180 and <= 180

Example: 72.8332

addressstringrequired

Full address, at least 3 characters.

Possible values: >= 3 characters

Example: Apollo Bunder, Colaba, Mumbai 400001

namestring | nullnullable

Place name, for example a hotel or station.

Example: The Taj Mahal Palace

citystring | nullnullable

City. Recommended: some providers need it to find the city they serve.

Example: Mumbai

country_codestring | nullnullable

ISO 3166-1 alpha-2, upper case. Recommended: providers limited to one country are skipped when the pickup is elsewhere.

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

Example: IN

tp_location_idstring | nullnullable

Location id agreed with Pathfndr, when you have one.

Possible values: <= 64 characters

Example: null

return_datestring | nullnullable

Round trip only: return pickup date, YYYY-MM-DD, local to the drop-off.

Example: 2026-11-29

return_timestring | nullnullable

Round trip only: return pickup time, HH:MM. At least 1 hour after the pickup.

Example: 18:00

PointToPointSearchRequest

{
  "pickup": {
    "lat": 18.9217,
    "lng": 72.8332,
    "name": "The Taj Mahal Palace",
    "address": "Apollo Bunder, Colaba, Mumbai 400001",
    "city": "Mumbai",
    "country_code": "IN"
  },
  "pickup_date": "2026-11-27",
  "pickup_time": "09:00",
  "adults": 2,
  "children": 0,
  "infants": 0,
  "luggage": 2,
  "currency": "INR",
  "providers": [
    "provider_a",
    "provider_b"
  ],
  "metadata": {},
  "transfer_type": "point_to_point",
  "trip_type": "round_trip",
  "dropoff": {
    "lat": 18.5308,
    "lng": 73.8475,
    "name": "Shivajinagar",
    "address": "Shivajinagar, Pune, Maharashtra 411005",
    "city": "Pune",
    "country_code": "IN"
  },
  "return_date": "2026-11-29",
  "return_time": "18:00"
}