Consultar un vehículo en el RUNT por placa

POST

/consults/vehicle

curl --request POST \
  --url https://api.notiauto.co/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, "history": 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

Placa sin espacios ni guiones, mayúsculas o minúsculas: ABC123 (carro), ABC12D o ABC12 (moto), 123ABC (motocarro), R12345 o S12345 (remolque y semirremolque), T1234, CC1234, OI1234, AT1234 o iniciales de país y tres números (diplomáticas).

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

history

Incluye historial: todos los SOAT, RTM y trámites. No cuesta otra consulta, solo hace la respuesta más pesada.

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

licencia_transito

Número de la licencia de tránsito (tarjeta de propiedad)

string

nullable

organismo_transito

string

nullable

tipo_carroceria

string

nullable

tipo_combustible

string

nullable

cilindraje

integer

nullable

puertas

integer

nullable

pasajeros_sentados

integer

nullable

peso_bruto_kg

integer

nullable

numero_ejes

integer

nullable

antiguo_clasico

boolean

nullable

alertas

Banderas del RUNT. null = el RUNT no lo informó (no es lo mismo que false).

object

prendas

boolean

nullable

gravamenes

boolean

nullable

regrabado_motor

boolean

nullable

regrabado_chasis

boolean

nullable

regrabado_serie

boolean

nullable

regrabado_vin

boolean

nullable

repotenciado

boolean

nullable

seguridad_estado

boolean

nullable

soat

One of:

ConsultSoat

ConsultSoat

Un SOAT según el RUNT (consulta de vehículo).

object

numero

string

estado

string

vigente

boolean

fecha_expedicion

string format: date

nullable

fecha_inicio

Desde cuándo cubre la póliza

string format: date

nullable

fecha_vencimiento

string format: date

nullable

aseguradora

string

estado_poliza

string

nullable

rtm

One of:

ConsultRtm

ConsultRtm

Una revisión técnico-mecánica según el RUNT (consulta de vehículo).

object

numero

string

fecha_revision

string format: date

nullable

fecha_vencimiento

string format: date

nullable

vigente

boolean

cda

string

estado

string

nullable

tipo_revision

string

nullable

historial

Solo con history: true. Cada lista va del vencimiento más lejano al más cercano; null = esa sección del RUNT no respondió.

object

soats

Array<object>

nullable

ConsultSoat

Un SOAT según el RUNT (consulta de vehículo).

object

numero

string

estado

string

vigente

boolean

fecha_expedicion

string format: date

nullable

fecha_inicio

Desde cuándo cubre la póliza

string format: date

nullable

fecha_vencimiento

string format: date

nullable

aseguradora

string

estado_poliza

string

nullable

rtms

Array<object>

nullable

ConsultRtm

Una revisión técnico-mecánica según el RUNT (consulta de vehículo).

object

numero

string

fecha_revision

string format: date

nullable

fecha_vencimiento

string format: date

nullable

vigente

boolean

cda

string

estado

string

nullable

tipo_revision

string

nullable

tramites

Array<object>

nullable

object

numero

string

nullable

fecha

string format: date

nullable

estado

string

nullable

tramites

Array<string>

entidad

string

nullable

Example

{
  "success": true,
  "cached": false,
  "data": {
    "plate": "ABC123",
    "marca": "CHEVROLET",
    "linea": "NPR",
    "modelo": "2020",
    "color": "BLANCO",
    "tipo_servicio": "Particular",
    "clase_vehiculo": "CAMION",
    "estado": "ACTIVO",
    "organismo_transito": "SECRETARIA DISTRITAL DE MOVILIDAD DE BOGOTA",
    "tipo_carroceria": "HATCH BACK",
    "tipo_combustible": "GASOLINA",
    "cilindraje": 1598,
    "puertas": 5,
    "pasajeros_sentados": 5,
    "peso_bruto_kg": 1560,
    "numero_ejes": 2
  },
  "soat": {
    "numero": "96333662",
    "estado": "VIGENTE",
    "vigente": true,
    "aseguradora": "SEGUROS DEL ESTADO",
    "estado_poliza": "EMITIDA"
  },
  "rtm": {
    "numero": "187525215",
    "vigente": true,
    "cda": "CDA EJEMPLO S.A.S.",
    "estado": "APROBADA",
    "tipo_revision": "REVISION TECNICO-MECANICO"
  },
  "historial": {
    "soats": [
      {
        "numero": "96333662",
        "estado": "VIGENTE",
        "vigente": true,
        "aseguradora": "SEGUROS DEL ESTADO",
        "estado_poliza": "EMITIDA"
      }
    ],
    "rtms": [
      {
        "numero": "187525215",
        "vigente": true,
        "cda": "CDA EJEMPLO S.A.S.",
        "estado": "APROBADA",
        "tipo_revision": "REVISION TECNICO-MECANICO"
      }
    ],
    "tramites": [
      {
        "estado": "APROBADA",
        "tramites": [
          "Tramite revision tecnico mecanica"
        ]
      }
    ]
  }
}

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."
}