Consultar un vehículo en el RUNT por placa

POST

/api/v1/consults/vehicle

curl --request POST \
  --url https://notiauto.co/api/v1/consults/vehicle \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <X-API-Key>' \
  --data '{ "plate": "ABC123", "type_document": "C", "document": "12345678", "refresh": false }'

• Producción

Requiere el scope consults.vehicle. El resultado se cachea 24 horas por (placa, tipo de documento, documento); cached indica si se sirvió del caché. Un fallo del RUNT nunca se cachea. Si el RUNT responde el vehículo pero falla una sección principal (SOAT o RTM), esa sección llega en null y la consulta NO se cachea, de modo que la siguiente petición vuelve a intentarlo. Si sólo falla una sección secundaria, la consulta se cachea unos minutos en vez de 24 horas.

Authorizations

• ApiKey

Request Body^required

Media typeapplication/json

object

plate

required

string

Example

ABC123

type_document

required

Tipo de documento del propietario

string

Example

C

document

required

string

Example

12345678

refresh

Ignora el caché y consulta al RUNT de nuevo.

boolean

Responses

200

Datos del vehículo según el RUNT

Media typeapplication/json

object

success

boolean

cached

boolean

data

object

plate

string

marca

string

linea

string

modelo

string

color

string

tipo_servicio

string

clase_vehiculo

string

estado

string

no_serie

string

no_motor

string

no_chasis

string

no_vin

string

fecha_matricula

string format: date

nullable

soat

object

rtm

object

Example

{
  "success": true,
  "cached": false,
  "data": {
    "plate": "ABC123",
    "marca": "CHEVROLET",
    "linea": "NPR",
    "modelo": "2020",
    "color": "BLANCO",
    "tipo_servicio": "Particular",
    "clase_vehiculo": "CAMION",
    "estado": "ACTIVO"
  }
}

422

Placa o documento con formato inválido

429

Límite de consultas de la key excedido

503

El RUNT no respondió o rechazó la consulta

Media typeapplication/json

Error

object

success

boolean

message

string

Example

{
  "success": false,
  "message": "API key inválida o expirada."
}