API de consulta vehicular de Chile: la ficha del vehículo por patente vía REST

Qué problema resuelve

Chile no tiene una consulta pública que devuelva la ficha de un vehículo en un formato que un backend pueda leer. El dato existe repartido entre el registro que consolida las plantas de revisión técnica y el registro de servicios de transporte público y escolar, cada uno con su propio formulario web y su propia forma de contestar. Quien necesita verificar cien vehículos —un inventario de usados, una flota que entra en contrato, una cartera que se está evaluando— termina consultando cien veces a mano y normalizando el resultado a ojo. Este endpoint entrega esa ficha en una llamada REST, con el mismo sobre y la misma API key que el resto del catálogo.

Para quién sirve

Compraventas y plataformas de usados en Chile, empresas de rastreo satelital que dan de alta unidades, aseguradoras y corredores que verifican antes de emitir, arrendadoras y operadores de flota, y equipos de producto que ya integraron PlacApi en otro país y quieren cubrir Chile sin escribir un segundo cliente.

Datos requeridos

• placa — la patente chilena de seis caracteres, en cualquiera de los tres formatos vigentes (BBCB01, AA1234, BBB010). Se aceptan guiones y puntos. El request acepta patente como alias del campo.
• refresh — opcional: salta la caché y vuelve a preguntarle al registro. Una consulta refrescada con datos cobra.

Fuentes y cobertura

• MTT — base central de revisión técnicaBase del Ministerio de Transportes y Telecomunicaciones que consolida las Plantas de Revisión Técnica del país. De ahí salen el tipo, la marca, la línea, el año, el VIN, el número de motor, el número de chasis y el sello de emisiones que trae la ficha.
• Registro Nacional de Servicios de Transporte Público y EscolarIndica si el vehículo está o estuvo inscrito como taxi, colectivo o transporte escolar. Alimenta el campo servicioPublico, que llega en null —no en false— si ese registro no respondió.

Seis campos de trece: qué publica Chile y qué no

El contrato de la ficha es el mismo en Colombia, Perú, Chile y México, y eso obliga a decir la verdad sobre las diferencias en vez de esconderlas. De los trece campos del contrato, los registros chilenos publican seis: tipo, marca, línea, modelo, servicioPublico y VIN. Los otros siete —clase, carrocería, capacidad de pasajeros, capacidad de carga, color, combustible y cilindraje— llegan en null porque Chile no los expone, no porque el vehículo no los tenga.

Esa distinción está explícita en la respuesta y no hay que deducirla: el bloque cobertura trae dos listas, disponibles y noPublicados. Un campo que aparece en noPublicados va a llegar en null para todas las patentes chilenas, siempre; un campo que aparece en disponibles y llega en null es un dato que ese vehículo concreto no tiene. Sin esas dos listas, las dos situaciones se ven idénticas desde el cliente y llevan a reintentar consultas que nunca van a traer nada.

A cambio, Chile publica tres campos que los otros países no: el sello de emisiones, el número de motor y el número de chasis. Van fuera de los trece del contrato común, así que un cliente escrito para Colombia los ignora sin romperse y uno escrito para Chile los aprovecha.

Esto no es el Certificado de Anotaciones Vigentes ni el padrón

En Chile las dos consultas que la gente busca por nombre son el Certificado de Anotaciones Vigentes y el padrón del vehículo, y las dos las emite el Servicio de Registro Civil e Identificación. Ninguna de las dos es lo que devuelve este endpoint, y conviene saberlo antes de integrar.

El CAV y el padrón son documentos de pago que acreditan la inscripción y su titular, y su emisión exige la ClaveÚnica del propio titular. No existe una vía por la que un tercero los obtenga con la patente sola, ni por API ni por formulario, y cualquier servicio que prometa lo contrario está prometiendo algo que el registro no entrega.

La ficha de /api/vehiculo-cl sale de otros registros y responde otra pregunta: qué vehículo es esa patente y para qué está habilitado. Sirve para identificar y verificar la unidad; no sirve para acreditar la propiedad ni para reemplazar un CAV en un trámite. Decirlo aquí evita la integración que se descubre inservible en producción.

servicioPublico: por qué null y false no son lo mismo

Saber si una patente está o estuvo inscrita como taxi, colectivo o transporte escolar es de las primeras cosas que se quieren averiguar antes de comprar un usado: un vehículo que trabajó de taxi tiene un uso muy distinto del que declara su kilometraje.

El campo tiene tres valores posibles y los tres significan cosas distintas. En true, el vehículo figura inscrito. En false, se consultó el registro y no figura. En null, el registro no respondió esa consulta, así que la pregunta quedó sin contestar. Devolver false cuando el registro no contestó sería inventar una respuesta tranquilizadora justo en el campo donde el error es más caro, y por eso ese caso se marca como ausencia.

Un cliente que trate null como false va a certificar como particular un vehículo sobre el que nunca se supo nada. La lectura correcta es reintentar con refresh o mostrarlo como dato no disponible.

¿Cómo consultar un vehículo chileno por patente desde una API?

Con una llamada POST a /api/vehiculo-cl enviando la patente en el campo placa, y la API key en el header x-api-key. La respuesta trae la ficha del vehículo y un bloque cobertura que dice qué campos publica Chile y cuáles no.

¿Se puede obtener el Certificado de Anotaciones Vigentes por API?

No. El CAV y el padrón los emite el Servicio de Registro Civil e Identificación, son de pago y su emisión exige la ClaveÚnica del titular; ningún tercero los obtiene con la patente sola. Este endpoint responde otra pregunta: qué vehículo es esa patente y para qué está habilitado.

Ejemplo de solicitud

POST https://placapi.com/api/vehiculo-cl. Autenticación por API key en el header x-api-key. Los datos del ejemplo son ficticios.

curl -X POST 'https://placapi.com/api/vehiculo-cl' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"placa":"BBCB01"}'

Ejemplo de respuesta

Respuesta JSON (fragmento con los campos de esta consulta; la API integral devuelve todas las fuentes en el mismo objeto).

{
  "source": "vehiculo",
  "status": "ok",
  "data": {
    "pais": "CL",
    "placa": "BBCB01",
    "clase": null,
    "tipo": "AUTOMOVIL",
    "carroceria": null,
    "marca": "TOYOTA",
    "linea": "NEW COROLLA LE 1.8",
    "capacidadPasajeros": null,
    "capacidadCargaKg": null,
    "color": null,
    "modelo": 2016,
    "servicioPublico": false,
    "vin": "5YFBURHEXGP323294",
    "combustible": null,
    "cilindraje": null,
    "tipoSello": "SELLO VERDE",
    "numeroMotor": "2ZRL702559",
    "numeroChasis": "5YFBURHEXGP323294",
    "servicioTransporte": null
  },
  "cobertura": {
    "disponibles": [
      "tipo",
      "marca",
      "linea",
      "modelo",
      "servicioPublico",
      "vin"
    ],
    "noPublicados": [
      "clase",
      "carroceria",
      "capacidadPasajeros",
      "capacidadCargaKg",
      "color",
      "combustible",
      "cilindraje"
    ]
  },
  "mode": "live",
  "cost": 1
}

Explicación campo por campo

Limitaciones y posibles errores

• Siete de los trece campos del contrato llegan siempre en null porque Chile no los publica: clase, carrocería, capacidad de pasajeros, capacidad de carga, color, combustible y cilindraje. Están enumerados en cobertura.noPublicados en cada respuesta.
• No es el Certificado de Anotaciones Vigentes ni el padrón del Registro Civil. Esos son documentos de pago que exigen la ClaveÚnica del titular y no se obtienen con la patente sola; este endpoint identifica el vehículo, no acredita su propiedad.
• No devuelve datos del propietario. Es una decisión, no una limitación técnica: la legislación chilena de protección de datos personales trata esa información como personal y PlacApi no la publica en ningún país.
• servicioPublico llega en null cuando el registro de transporte público no responde. Tratarlo como false certifica como particular un vehículo del que no se supo nada.
• Una patente que no figura en los registros es una respuesta válida y cobra 1 crédito: «esta patente no existe en el registro» es información. Lo que no cobra es un fallo de la fuente, que devuelve data en null y reembolsa el crédito reservado.

Códigos de error del endpoint (401, 402, 429, 5xx) en la referencia de errores.

Otras preguntas frecuentes

Seguir explorando

• Revisión técnica por patente en Chile: el historial de las PRT→
• Multas por patente en Chile y el permiso de circulación→
• Validar el SOAP chileno contra el registro de las aseguradoras→
• Consulta vehicular SUNARP: la misma ficha, otro país→
• API de consulta vehicular Colombia: la ficha del RUNT→
• Referencia del endpoint POST /api/vehiculo-cl→
• Todos los endpoints de Chile→