GET/v1/transfers/reservations/:reservationId

Obtener una reserva de transfer

Consulta una única reserva por su reservation ID.

Compartir
GET/v1/transfers/reservations/:reservationId

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.

Parámetros de ruta

1 campo

ID de reserva

Identificador de reserva devuelto al crear el booking. En el endpoint de detalles unificados, envía solo uno entre reservationId, confirmationNumber o searchId.

Parámetros de consulta

3 campos

Proveedor GDS

Selector de contenido de transfers. Actualmente solo 0.

Moneda

Moneda de los importes devueltos. Debe coincidir con la oferta o la reserva cuando ya existe una.

Idioma

Campo de idioma legacy. Es preferible usar el header LANG o Accept-Language.

Petición cURL

cURL
bash
curl -X GET 'https://api.sandbox.travelandz.com/v1/transfers/reservations/:reservationId?gdsprovider=0&currency=USD' \
  -H 'Authorization: Bearer YOUR_SECRET_KEY' \
  -H 'X-Travelandz-Id: YOUR_PUBLIC_KEY:YOUR_PROFILE_CODE'

Añade tus credenciales para enviar una petición.

Esta petición necesita identificadores o tokens de una llamada anterior. Ejecuta primero el paso previo y pega aquí sus valores.

Respuesta

Pulsa «¡Pruébalo!» para enviar una petición y ver la respuesta aquí.

Consulta una única reserva por su reservation ID.

Autenticación y headers

HeaderDescripción
AuthorizationBearer <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>.
LANGHeader recomendado para el idioma. También se acepta Accept-Language.
Content-Typeapplication/json para peticiones con body JSON.

Petición

Este endpoint no recibe body. reservationId va en el path y gdsprovider en la query.

Schema de parámetros

reservationId
stringSí
Reservation identifier returned when the booking was created.

Schema de query params

gdsprovider
enum
0
Sí
Transfer content selector. Currently 0.
currency
enum
EURUSDINRCHFJPYGBPAUDCADCNYSGDNZDMXN
No
Lowercase values are accepted and normalized. Defaults to USD on a new search and is inherited afterwards.
language
enum
en-USes-ESde-DEfr-FRpt-BRzh-CNit-IT
No
Legacy field. Prefer the LANG or Accept-Language header.

Respuesta exitosa

Devuelve directamente un objeto de reserva, no el envelope que usan los otros endpoints de lectura.

Schema de respuesta

gdsprovider
enum
0
Sí
reservationId
stringSí
Persist this value; reservation reads and cancellation need it.
confirmationNumber
stringNo
Traveller-facing confirmation code.
status
enum
completedpendingfailed
Sí
cancelled
booleanSí
totalAmount
numberSí
Total charged for the reservation.
currency
enum
EURUSDINRCHFJPYGBPAUDCADCNYSGDNZDMXN
Sí
pickupInstructions
stringNo
ticketUrl
string
Formato: URL
No
selectedScheduleIndex
numberNo
departureDatetime
string
Formato: ISO 8601
No
arrivalDatetime
string
Formato: ISO 8601
No
selectedAmenities
arraySí
selectedAmenities[]key
stringSí
Value to send in selectedAmenities.
selectedAmenities[]name
stringSí
Localized name.
selectedAmenities[]description
stringNo
selectedAmenities[]imageUrl
string
Formato: URL
No
selectedAmenities[]pngImageUrl
string
Formato: URL
No
selectedAmenities[]inputType
enum
booleannumeric
No
selectedAmenities[]included
booleanSí
True when the amenity is already part of the offer.
selectedAmenities[]selectable
booleanSí
True when the amenity can be added to this offer.
selectedAmenities[]selected
booleanSí
True when the amenity is part of the priced selection.

Ejemplos de respuesta

json
json
{
  "gdsprovider": 0,
  "reservationId": "b8150702cb874abc8d592610afa2a2d9",
  "confirmationNumber": "TZ-6202191",
  "status": "completed",
  "cancelled": false,
  "totalAmount": 1462.82,
  "currency": "USD",
  "pickupInstructions": "Your driver will be waiting for you near the baggage claim with your name on a sign.",
  "departureDatetime": "2026-08-16T14:40:00-04:00",
  "arrivalDatetime": "2026-08-16T15:06:00-04:00",
  "selectedAmenities": []
}

Errores

HTTPCódigoSignificadoAcción recomendada
400El body, la query o el path son inválidos, o incluyen una propiedad desconocida.Corrige la petición usando el array message.
400transfer_invalid_currencyLa moneda está fuera de la lista soportada.Usa una moneda soportada.
400transfer_invalid_languageEl idioma solicitado no está soportado.Usa uno de los valores de idioma documentados.
429transfer_provider_errorEl servicio está temporalmente limitado por rate limit.Reintenta con backoff exponencial.
502transfer_provider_errorLa petición no pudo completarse.No asumas que tuvo éxito. Conserva tus identificadores y consulta la reserva cuando la operación pudiera haberse creado.
400transfer_currency_mismatchLa moneda no coincide con la oferta, la cotización o la reserva.Reutiliza la moneda devuelta por el paso anterior, u omite el campo para heredarla.
503El precio no pudo confirmarse en este momento.Reintenta más tarde. No reserves ni cobres al viajero.

Notas de uso

Este endpoint solo devuelve la primera reserva del resultado. Para reservas creadas con amenities, consúltalas por searchId para no perder información.

Ejemplo cURL

bash
bash
curl --request GET \
  --url "https://api.sandbox.travelandz.com/v1/transfers/reservations/b8150702cb874abc8d592610afa2a2d9?gdsprovider=0&currency=USD" \
  -H "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  -H "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE"