GET/v1/transfers/reservations/:reservationId/vehicle

Obtener driver y vehículo del transfer

Consulta el driver y el vehículo asignados a una reserva.

GET/v1/transfers/reservations/:reservationId/vehicle

Consola API

Pruébalo

Envía una petición real al entorno sandbox e inspecciona la respuesta.

Credenciales

Profile code

Public key

Secret key

Inicia sesión para elegir entre tus API keys guardadas en vez de pegarlas.

Parámetros de ruta

1 campo

reservationIdstringObligatorio

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

2 campos

currencystring ISO 4217Opcional

Moneda

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

languagestringOpcional

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/vehicle?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 el driver y el vehículo asignados a una reserva.

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

Este endpoint no recibe body. reservationId va en el path.

Schema de parámetros

reservationId

stringSí

Reservation identifier returned when the booking was created.

Schema de query params

currency

enum

EURUSDINRCHFJPYGBPAUDCADCNYSGDNZDMXN

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

Legacy field. Prefer the LANG or Accept-Language header.

Respuesta exitosa

driver y vehicle se omiten hasta que exista una asignación, así que construye la interfaz para manejar una respuesta que solo traiga status.

Schema de respuesta

status

stringNo

Assignment state, for example active.

driver

objectSí

driverid

stringNo

driverexternalId

stringNo

drivername

stringNo

driverphone

stringNo

driverlicenseNumber

stringNo

driverimageUrl

string

Formato: URL

vehicle

objectSí

vehicleid

stringNo

vehicleexternalId

stringNo

vehicletype

stringNo

vehiclemanufacturer

stringNo

vehiclemodel

stringNo

vehicleplate

stringNo

vehiclecolor

stringNo

vehicledescription

stringNo

vehicleimageUrl

string

Formato: URL

Ejemplos de respuesta

json

{
  "status": "active",
  "driver": {
    "id": "123",
    "externalId": "DRV456",
    "name": "John Doe",
    "phone": "+1234567890",
    "licenseNumber": "AB123456",
    "imageUrl": "https://cdn.example.com/drivers/driver123.jpg"
  },
  "vehicle": {
    "id": "789",
    "externalId": "VEH789",
    "type": "Sedan",
    "manufacturer": "Toyota",
    "model": "Camry",
    "plate": "XYZ1234",
    "color": "Blue",
    "description": "A blue Toyota Camry in excellent condition.",
    "imageUrl": "https://cdn.example.com/vehicles/vehicle789.jpg"
  }
}

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

Consulta este endpoint una vez cuando el viajero abra la reserva. Si necesitas que la asignación se actualice en pantalla sin acción del usuario, usa el endpoint de stream en lugar de pedir este en bucle.

Ejemplo cURL

bash

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