Consultar la info de un vehiculo

[ GET ]

Consulta la información de un vehículo sin alterar los valores del mismo.

https://sync.airbagtech.io/vehicle/{{VEHICLE_ID}}

Campos

Nombre	Tipo	Requerido	Descripción
VEHICLE_ID	String	Sí	ID del vehículo a consultar. Acepta el ID que tu empresa usó al crearlo o el airbagId. Este valor deberá ir en la ruta.

Headers

Authorization
apikey {{API_KEY}}

Ejemplo

curl --location -g 'https://sync.airbagtech.io/vehicle/{{VEHICLE_ID}}' \
--header 'Authorization: apikey {{API_KEY}}'

Respuestas

✅ Respuesta exitosa (200 OK)

Devuelve la ficha completa del vehículo solicitado. Los campos que no hayan sido informados al momento de crear o editar el vehículo se devuelven como cadenas vacías ("").

{
  "status": true,
  "vehicle": {
    "niv": "3VWFE21C04M000111",
    "brand": "toyota",
    "fuel": "f-gas",
    "uid": "UN-0012",
    "vehicleType": "s-vehicle",
    "model": "Corolla",
    "plate": "ABC-123",
    "airbagId": "a1b2c3d4_e5f6_4708_9102_3456789abcde",
    "internalCompanyId": "VH-001",
    "company": "Transportes Ejemplo"
  }
}

Descripción de campos de respuesta

Campo	Tipo	Descripción
status	Boolean	Indica si la operación fue exitosa.
vehicle	Object	Objeto con los datos completos del vehículo.

Campos dentro de vehicle

Campo	Tipo	Descripción
airbagId	String	Identificador interno único del vehículo en la plataforma Airbag. Útil para operaciones internas y referencias cruzadas.
uid	String	Nombre a mostrar del vehículo (unit ID, número económico, etc.). Al crear o editar se envía como name.
internalCompanyId	String	ID del vehículo definido por tu empresa: el id enviado al crearlo. Es el ID que utilizas en tus sistemas. Puede faltar en vehículos registrados sin ese ID.
company	String	Nombre de la organización propietaria del vehículo.
brand	String	Marca del vehículo (por ejemplo toyota, mazda, volkswagen). Consulta los valores soportados en Vehículos › Tipos de vehículos.
model	String	Modelo del vehículo (por ejemplo Corolla, CX-30). Puede estar vacío si no se cargó.
plate	String	Placa o matrícula del vehículo. Puede estar vacía si no se cargó.
niv	String	Número de Identificación Vehicular (VIN). Puede estar vacío si no se cargó.
fuel	String	Tipo de combustible. Valores soportados: f-gas, f-diesel, f-electric. Consulta la tabla en Vehículos › Tipos de combustible. Puede estar vacío si no se cargó.
vehicleType	String	Categoría del vehículo. Valores comunes: s-vehicle (vehículo estándar), van, motorcycle, así como las categorías de carga (T2-S1, B2, B3, C2, etc.). Consulta la lista completa en Vehículos › Tipos de vehículos. Puede estar vacío si no se cargó.

❌ Vehículo no encontrado (400 Bad Request)

Se devuelve cuando el VEHICLE_ID proporcionado no corresponde a ningún vehículo registrado.

{
  "status": false,
  "message": "Error: Vehicle not found",
  "errorId": "sentry_error_id_123"
}