GET/v1/transfers/reservations/by-confirmation/:confirmationNumber

Obtener reserva por confirmation number

Consulta una reserva cuando el confirmation number es el identificador del que dispones.

Compartir
GET/v1/transfers/reservations/by-confirmation/:confirmationNumber

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

Confirmation number

Confirmation number 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/by-confirmation/:confirmationNumber?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 reserva cuando el confirmation number es el identificador del que dispones.

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. confirmationNumber va en el path y gdsprovider en la query.

Schema de parámetros

confirmationNumber
stringSí
Confirmation number 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 el mismo envelope de reserva que el endpoint de detalles unificados.

Schema de respuesta

status
enum
completedpendingfailed
Sí
completed
booleanSí
Treat the operation as confirmed only when this is true and reservations is not empty.
timedOut
booleanSí
True when a final state was not reached in time.
reservations
arraySí
reservations[]gdsprovider
enum
0
Sí
reservations[]reservationId
stringSí
Persist this value; reservation reads and cancellation need it.
reservations[]confirmationNumber
stringNo
Traveller-facing confirmation code.
reservations[]status
enum
completedpendingfailed
Sí
reservations[]cancelled
booleanSí
reservations[]totalAmount
numberSí
Total charged for the reservation.
reservations[]currency
enum
EURUSDINRCHFJPYGBPAUDCADCNYSGDNZDMXN
Sí
reservations[]pickupInstructions
stringNo
reservations[]ticketUrl
string
Formato: URL
No
reservations[]selectedScheduleIndex
numberNo
reservations[]departureDatetime
string
Formato: ISO 8601
No
reservations[]arrivalDatetime
string
Formato: ISO 8601
No
reservations[]selectedAmenities
arraySí
reservations[]selectedAmenities[]key
stringSí
Value to send in selectedAmenities.
reservations[]selectedAmenities[]name
stringSí
Localized name.
reservations[]selectedAmenities[]description
stringNo
reservations[]selectedAmenities[]imageUrl
string
Formato: URL
No
reservations[]selectedAmenities[]pngImageUrl
string
Formato: URL
No
reservations[]selectedAmenities[]inputType
enum
booleannumeric
No
reservations[]selectedAmenities[]included
booleanSí
True when the amenity is already part of the offer.
reservations[]selectedAmenities[]selectable
booleanSí
True when the amenity can be added to this offer.
reservations[]selectedAmenities[]selected
booleanSí
True when the amenity is part of the priced selection.
error
stringNo
Present when status is failed.
metadata
objectSí
metadatauseSearchIdForDetails
booleanSí
True when reservation details must be read with searchId instead of reservationId.
metadatadetailsIdentifier
enum
reservationIdsearchId
Sí
Identifier to use when reading the reservation.
metadatadetailsSearchId
stringNo
Present when detailsIdentifier is searchId.
metadatamessage
stringNo

Ejemplos de respuesta

json
json
{
  "status": "completed",
  "completed": true,
  "timedOut": false,
  "reservations": [
    {
      "gdsprovider": 0,
      "reservationId": "f390daff1fdf4cccb19b7abd825dc011",
      "confirmationNumber": "TZ-6202191",
      "status": "completed",
      "cancelled": false,
      "totalAmount": 181.97,
      "currency": "USD",
      "pickupInstructions": "The driver will call you when he arrives.",
      "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

Las reservas con amenities seleccionadas solo se devuelven completas por el endpoint por search ID. Usa este alias para reservas sin amenities, o cuando el confirmation number es todo lo que tienes.

Ejemplo cURL

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