API console
Try it
Send a real request to the sandbox API and inspect the response.
Credentials
Log in to pick from your saved API keys instead of pasting them.
Request body
cURL request
curl -X POST 'https://api.sandbox.travelandz.com/v1/transfers/flights/verify' \
-H 'Authorization: Bearer YOUR_SECRET_KEY' \
-H 'X-Travelandz-Id: YOUR_PUBLIC_KEY:YOUR_PROFILE_CODE' \
-H 'Content-Type: application/json' \
-d '{"returnVoyage":true,"pickupDatetime":"2026-06-26T08:00:00+07:00","airlineCode":"5J","airportCode":"BKK","flightDirection":"dep","flightNumber":"930","currency":"USD"}'Add your credentials to send a request.
Response
Click "Try it!" to send a request and see the response here.
Check whether a flight fits the requested pickup time.
Authentication and headers
| Header | Description |
|---|---|
Authorization | Bearer <secret_key>. Keep the secret on the server and never write it to client logs. |
X-Travelandz-Id | <public_key>:<profile_code>, where the persisted profile code has the form dp_<12 alphanumeric>. |
LANG | Preferred locale header. Accept-Language is also supported. |
Content-Type | application/json for requests with a JSON body. |
Request
Send the flight identity and the pickup time you intend to book. Set returnVoyage when you are checking the return leg.
Request Body Schema
pickupDatetimeairlineCodeairportCodeflightDirectionflightNumberreturnVoyagesearchIdcurrencyUSD on a new search and is inherited afterwards.languageLANG or Accept-Language header.Request example
{
"returnVoyage": true,
"pickupDatetime": "2026-06-26T08:00:00+07:00",
"airlineCode": "5J",
"airportCode": "BKK",
"flightDirection": "dep",
"flightNumber": "930",
"currency": "USD"
}Success response
isValid: false is a successful verification, not an error: the flight and the pickup time do not fit together. When that happens, possiblePickupDatetime suggests a pickup time that would work, and message explains the problem in the requested language.
Response Body Schema
isValid200 outcome: the flight does not fit the pickup time.messageTitlemessagepossiblePickupDatetimeResponse examples
{
"isValid": false,
"messageTitle": "Late Arrival!",
"message": "You're expected to arrive at the airport at <b>9:30AM</b>.<br/>This gives you 1 hours and 45 minutes until your flight.<br/>To ensure you don't miss it, we recommend arriving 3 hours before departure.",
"possiblePickupDatetime": "2026-06-26T06:45:00+07:00"
}Errors
| HTTP | Code | Meaning | Recommended action |
|---|---|---|---|
400 | The body, query or path is invalid, or contains an unknown property. | Fix the request using the message array. | |
400 | transfer_invalid_currency | The currency is outside the supported list. | Use a supported currency. |
400 | transfer_invalid_language | The requested language is not supported. | Use one of the documented language values. |
429 | transfer_provider_error | The service is temporarily rate limited. | Retry with exponential backoff. |
502 | transfer_provider_error | The request could not be completed. | Do not assume success. Keep your identifiers and read the reservation when the operation could have been created. |
Usage notes
message can contain basic HTML tags, so render it as rich text or strip the tags before displaying it. Verify the flight before booking so the traveller can adjust the pickup time instead of discovering the problem on the day of travel.
cURL example
curl --request POST \
--url "https://api.sandbox.travelandz.com/v1/transfers/flights/verify" \
-H "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
-H "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE" \
-H "Content-Type: application/json" \
--data '{
"returnVoyage": true,
"pickupDatetime": "2026-06-26T08:00:00+07:00",
"airlineCode": "5J",
"airportCode": "BKK",
"flightDirection": "dep",
"flightNumber": "930",
"currency": "USD"
}'