Consola API
Pruébalo
Envía una petición real al entorno sandbox e inspecciona la respuesta.
Credenciales
Inicia sesión para elegir entre tus API keys guardadas en vez de pegarlas.
Cuerpo de la petición
Petición cURL
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"}'Añade tus credenciales para enviar una petición.
Respuesta
Pulsa «¡Pruébalo!» para enviar una petición y ver la respuesta aquí.
Comprueba si un vuelo encaja con la hora de pickup solicitada.
Autenticación y headers
| Header | Descripción |
|---|---|
Authorization | Bearer <secret_key>. Conserva el secret en el servidor y nunca lo escribas en logs del cliente. |
X-Travelandz-Id | <public_key>:<profile_code>, donde el profile code persistido usa el formato dp_<12 alfanuméricos>. |
LANG | Header recomendado para el idioma. También se acepta Accept-Language. |
Content-Type | application/json para peticiones con body JSON. |
Petición
Envía la identidad del vuelo y la hora de pickup que piensas reservar. Usa returnVoyage cuando estés comprobando el tramo de retorno.
Schema del body
pickupDatetimeairlineCodeairportCodeflightDirectionflightNumberreturnVoyagesearchIdcurrencyUSD on a new search and is inherited afterwards.languageLANG or Accept-Language header.Ejemplo de petición
{
"returnVoyage": true,
"pickupDatetime": "2026-06-26T08:00:00+07:00",
"airlineCode": "5J",
"airportCode": "BKK",
"flightDirection": "dep",
"flightNumber": "930",
"currency": "USD"
}Respuesta exitosa
isValid: false es una verificación exitosa, no un error: el vuelo y la hora de pickup no encajan. En ese caso, possiblePickupDatetime sugiere una hora de pickup que sí funcionaría, y message explica el problema en el idioma solicitado.
Schema de respuesta
isValid200 outcome: the flight does not fit the pickup time.messageTitlemessagepossiblePickupDatetimeEjemplos de respuesta
{
"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"
}Errores
| HTTP | Código | Significado | Acción recomendada |
|---|---|---|---|
400 | El body, la query o el path son inválidos, o incluyen una propiedad desconocida. | Corrige la petición usando el array message. | |
400 | transfer_invalid_currency | La moneda está fuera de la lista soportada. | Usa una moneda soportada. |
400 | transfer_invalid_language | El idioma solicitado no está soportado. | Usa uno de los valores de idioma documentados. |
429 | transfer_provider_error | El servicio está temporalmente limitado por rate limit. | Reintenta con backoff exponencial. |
502 | transfer_provider_error | La petición no pudo completarse. | No asumas que tuvo éxito. Conserva tus identificadores y consulta la reserva cuando la operación pudiera haberse creado. |
Notas de uso
message puede contener HTML básico, así que renderízalo como texto enriquecido o elimina las etiquetas antes de mostrarlo. Verifica el vuelo antes de reservar para que el viajero pueda ajustar el pickup en lugar de descubrir el problema el día del viaje.
Ejemplo cURL
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"
}'