Ground Transport Bookings
Book a vehicle, poll for confirmation, and manage reservations.
Ground Transport Bookings
After polling a search and selecting a result_id, book the vehicle and poll for confirmation.
Create Booking
POST /v1/travel/ground-transport/bookings
Returns a search_id to poll for confirmation. Use the result_id from the search poll response.
| Field | Type | Required | Description |
|---|---|---|---|
search_id | string | yes | From the search endpoint |
result_id | string | yes | Vehicle option selected from poll |
passenger | object | yes | { first_name, last_name, email, phone } |
flight_number | string | no | For airport pickups — enables flight tracking |
https://cloud.vanitypass.com with X-Environment: Sandbox. No real bookings or charges. Production access: contact us./v1/travel/ground-transport/bookingsSandbox credentials
Keys never leave your browser — they are sent only to cloud.vanitypass.com with X-Environment: Sandbox.
curl -X POST 'https://cloud.vanitypass.com/v1/travel/ground-transport/bookings' \
-H 'Content-Type: application/json' \
-H 'X-Environment: Sandbox' \
-d '{"search_id":"srch_example","result_id":"res_example","passenger":{"first_name":"Jane","last_name":"Doe","email":"jane@example.com","phone":"+447700900000"},"flight_number":"BA123"}'Poll Booking Confirmation
GET /v1/travel/ground-transport/bookings/{search_id}/poll
Repeat every 2 seconds until status is confirmed or failed.
https://cloud.vanitypass.com with X-Environment: Sandbox. No real bookings or charges. Production access: contact us./v1/travel/ground-transport/bookings/{search_id}/pollSandbox credentials
Keys never leave your browser — they are sent only to cloud.vanitypass.com with X-Environment: Sandbox.
curl -X GET 'https://cloud.vanitypass.com/v1/travel/ground-transport/bookings/{search_id}/poll' \
-H 'Content-Type: application/json' \
-H 'X-Environment: Sandbox' \Booking History
GET /v1/travel/ground-transport/bookings/history
https://cloud.vanitypass.com with X-Environment: Sandbox. No real bookings or charges. Production access: contact us./v1/travel/ground-transport/bookings/historySandbox credentials
Keys never leave your browser — they are sent only to cloud.vanitypass.com with X-Environment: Sandbox.
curl -X GET 'https://cloud.vanitypass.com/v1/travel/ground-transport/bookings/history' \ -H 'Content-Type: application/json' \ -H 'X-Environment: Sandbox' \
Cancel Booking
POST /v1/travel/ground-transport/bookings/cancel
| Field | Type | Required | Description |
|---|---|---|---|
booking_id | string | yes | Booking to cancel |
https://cloud.vanitypass.com with X-Environment: Sandbox. No real bookings or charges. Production access: contact us./v1/travel/ground-transport/bookings/cancelSandbox credentials
Keys never leave your browser — they are sent only to cloud.vanitypass.com with X-Environment: Sandbox.
curl -X POST 'https://cloud.vanitypass.com/v1/travel/ground-transport/bookings/cancel' \
-H 'Content-Type: application/json' \
-H 'X-Environment: Sandbox' \
-d '{"booking_id":"book_example"}'