GET/v1/transfers/tracking/:reservationId/events/latest

Obtener el último evento de tracking

Consulta la última posición conocida del vehículo y el estado del viaje de una reserva.

GET/v1/transfers/tracking/:reservationId/events/latest

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/tracking/:reservationId/events/latest?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 la última posición conocida del vehículo y el estado del viaje de 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

Todos los campos se omiten mientras no exista información de tracking, así que un objeto vacío es una respuesta 200 válida. No trates un location ausente como un error antes de que empiece el viaje.

Schema de respuesta

location

objectSí

locationlatitude

numberNo

locationlongitude

numberNo

status

stringNo

Journey state, for example driver_departed_to_pickup.

timestamp

string

Formato: ISO 8601

trackingId

stringNo

Ejemplos de respuesta

json

{
  "location": {
    "latitude": 40.7607634,
    "longitude": -73.971212
  },
  "status": "driver_departed_to_pickup",
  "timestamp": "2026-07-25T17:47:01.761854Z",
  "trackingId": "c90n51960f274447b29473fc0d995f6a"
}

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

El tracking nunca realiza conversión de moneda; currency solo se valida. Usa el endpoint de stream cuando el viajero esté viendo un mapa en vivo.

Ejemplo cURL

bash

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