Search Ground Transport

Ground transport uses an async pattern: POST to start a search, then poll until results are ready. All requests carry the white-label headers Authorization: Bearer <JWT>, X-App-Id, and X-Environment.

Search Available Rides

POST /v1/travel/ground-transport

Search for available vehicles and pricing for a route. Returns a search_id. Poll the results endpoint until status is complete.

curl -X POST 'https://cloud.vanitypass.com/v1/travel/ground-transport' \
  -H 'Content-Type: application/json' \
  -H 'X-Environment: Sandbox' \
  -d '{"start_address":"Heathrow Airport, London","end_address":"1 Buckingham Palace Rd, London SW1W 0QT","pickup_datetime":"2026-07-01T10:00:00Z","num_passengers":2,"currency":"USD"}'

Poll Search Results

GET /v1/travel/ground-transport/{search_id}/poll

Repeat every 2 seconds until more_coming is false. Quotes arrive across several polls — the initial search response carries none. Carry a quote's id into the quote and booking requests.

Response fields:

• more_coming — true while more suppliers are still responding
• currency — the search currency; every price in the response is in it
• quotes — available vehicles with pricing

Each quote's price is the full fare for the itinerary, already including any supplier fees — the same amount POST /v1/travel/quotes returns at checkout for that quote in the same currency. Amenity price values are likewise the amount charged to add the amenity, so nothing new appears at checkout.

make and model are supplier-reported and often null. Fall back to vehicle_description (free text, usually names the car), then vehicle_type + vehicle_class.

curl -X GET 'https://cloud.vanitypass.com/v1/travel/ground-transport/{search_id}/poll' \
  -H 'Content-Type: application/json' \
  -H 'X-Environment: Sandbox' \

Filter and Sort Results

POST /v1/travel/ground-transport/{search_id}/poll

Same endpoint, with a filters-only JSON body. Filter on the poll, not the search — the search response carries no quotes yet, so filters passed there have nothing to match against.

Every field is optional and unknown fields are ignored, so re-posting the original search body also works. A malformed body, or a filter value outside the supported taxonomy (e.g. "Platinum" as a vehicle class), returns 400 — filters are never silently ignored.

curl -X POST 'https://cloud.vanitypass.com/v1/travel/ground-transport/{search_id}/poll' \
  -H 'Content-Type: application/json' \
  -H 'X-Environment: Sandbox' \
  -d '{"filter_vehicle_classes":["First Class"],"sort_by":"price_asc"}'