API de revisión técnica de Chile: las PRT por patente vía REST

Qué problema resuelve

Verificar que un vehículo chileno tiene la revisión técnica al día es un requisito de contratación para una flota, una condición antes de emitir una póliza y una alerta de vencimiento para quien administra unidades ajenas. El registro se consulta patente por patente desde un formulario, sin API y sin descarga masiva, así que revisar una flota de cien unidades significa cien consultas manuales y una hoja de cálculo que envejece sola. Este endpoint convierte esa verificación en una llamada REST que se puede correr en lote, programar como cron o disparar cuando una unidad entra al inventario.

Para quién sirve

Operadores de flota y de transporte en Chile, empresas de rastreo satelital que dan de alta unidades, aseguradoras y corredores que verifican requisitos antes de emitir, arrendadoras y plataformas de usados, y áreas de cumplimiento que auditan la documentación de vehículos contratados a terceros.

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: fecha de la revisión, código y nombre de la planta, número de certificado, fecha de vencimiento y estado de cada revisión, más la ficha del vehículo revisado.

«Revisión vencida» significa aprobada y expirada, no rechazada

Es la trampa más cara de este registro y la que hace que una integración ingenua reporte la vigencia del año anterior. El portal reescribe el estado de la revisión más reciente: cuando su fecha de vencimiento ya pasó, la marca como vencida. Las revisiones antiguas, en cambio, conservan el rótulo Aprobado que tenían cuando se emitieron.

El efecto es contraintuitivo. Un vehículo que aprobó su revisión en abril de 2025 y la dejó expirar en agosto va a mostrar su revisión más nueva como vencida y las anteriores como aprobadas. Un cliente que filtre el historial por estado igual a Aprobado y tome la fecha de vencimiento más alta de ese subconjunto se va a quedar con el certificado del año pasado y va a reportar una vigencia que caducó hace más de un año.

«Vencida» aquí no describe el resultado de la inspección sino la situación del certificado hoy. Un vehículo con revisión vencida pasó la inspección; lo que no tiene es un certificado al día. Por eso el endpoint no obliga a interpretar el historial: vigente ya trae el veredicto calculado, y vigenteHasta trae la fecha del certificado más reciente, esté al día o no.

Por qué cada revisión aparece dos veces

Cada revisión aprobada llega en dos entradas del arreglo, una con tipo mecanica y otra con tipo gases, y las dos comparten fecha, planta y número de certificado. No es una duplicación del endpoint: son las dos pruebas que componen el mismo certificado, y el registro las publica por separado porque se aprueban por separado.

Eso importa al contar. Un cliente que muestre «cantidad de revisiones» sobre la longitud del arreglo va a reportar el doble de las que hubo. Para contar revisiones hay que agrupar por número de certificado; para saber qué se aprobó, mirar las dos filas.

Y una puede faltar. Cuando solo aparece una de las dos pruebas para un certificado, es información: significa que el registro tiene constancia de una y no de la otra. Colapsar las dos filas en una sin mirar el tipo esconde exactamente ese caso.

Los tres estados de la respuesta, y qué hacer con cada uno

El campo status resume la situación sin obligar a recorrer el historial. Es ok cuando hay una revisión vigente. Es warn cuando solo hay historial vencido: el vehículo pasó revisiones antes, pero hoy no tiene ninguna al día. Es info cuando la patente no tiene revisiones registradas.

La diferencia entre warn e info es la que decide qué mostrarle a un operador. Un vehículo en warn tiene un dueño que dejó vencer la revisión y una fecha desde la cual está en falta, que sale de vigenteHasta. Un vehículo en info puede ser reciente, puede estar exento, o puede no haber pasado nunca por una planta; con este endpoint solo, no se distinguen esas tres cosas, y por eso no se rotula como incumplimiento.

vigenteHasta se entrega también cuando ya venció, y esa es la razón: permite responder «desde cuándo» en vez de solo «no está al día». Un cliente que solo lea vigente pierde la mitad del dato útil para una gestión de cobranza o de renovación.

¿Cómo consultar la revisión técnica de un vehículo chileno por API?

Con una llamada POST a /api/revision-tecnica-cl enviando la patente en el campo placa, y la API key en el header x-api-key. La respuesta trae vigente y vigenteHasta para contestar de una vez si está al día, y el historial completo de revisiones con planta, certificado y estado.

¿Qué significa que una revisión aparezca como «vencida»?

Que el vehículo la aprobó y el certificado ya expiró. El registro reescribe así el estado de la revisión más reciente cuando pasó su fecha de vencimiento; no quiere decir que la haya reprobado. Las revisiones antiguas conservan el rótulo Aprobado, y por eso filtrar por Aprobado devuelve el certificado del año anterior.

Ejemplo de solicitud

POST https://placapi.com/api/revision-tecnica-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/revision-tecnica-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": "rtm",
  "status": "warn",
  "data": {
    "pais": "CL",
    "placa": "BBCB01",
    "vehiculo": {
      "tipo": "AUTOMOVIL",
      "marca": "TOYOTA",
      "modelo": "NEW COROLLA LE 1.8",
      "anioFabricacion": "2016",
      "numeroMotor": "2ZRL702559",
      "numeroChasis": "5YFBURHEXGP323294",
      "vin": null,
      "tipoSello": "SELLO VERDE"
    },
    "vigente": false,
    "vigenteHasta": "2025-08-31",
    "revisiones": [
      {
        "fecha": "2025-04-03",
        "codigoPlanta": "B-1343",
        "planta": "REVISIONES TÉCNICAS SAN DÁMASO S.A.",
        "numeroCertificado": "B1343000000436281",
        "fechaVencimiento": "2025-08-31",
        "estado": "Aprobado",
        "tipo": "mecanica"
      },
      {
        "fecha": "2025-04-03",
        "codigoPlanta": "B-1343",
        "planta": "REVISIONES TÉCNICAS SAN DÁMASO S.A.",
        "numeroCertificado": "B1343000000436281",
        "fechaVencimiento": "2025-08-31",
        "estado": "Aprobado",
        "tipo": "gases"
      }
    ]
  },
  "mode": "live",
  "cost": 1
}

Explicación campo por campo

Limitaciones y posibles errores

• El estado del historial no se puede leer como el resultado de la inspección. El registro marca como vencida la revisión más reciente cuando su fecha ya pasó, y deja Aprobado en las anteriores; filtrar por Aprobado y tomar el vencimiento más alto reporta la vigencia del año anterior.
• Cada revisión aprobada aparece en dos entradas, una de mecánica y otra de gases. Contar la longitud del arreglo reporta el doble de revisiones de las que hubo: hay que agrupar por número de certificado.
• Un status info no equivale a incumplimiento. Una patente sin revisiones puede ser un vehículo reciente, uno exento o uno que nunca pasó por una planta, y este endpoint solo no distingue esos tres casos.
• No cubre la licencia de conducir del conductor: en Chile el estado de la licencia solo se consulta con la clave del propio titular, así que no hay endpoint que lo entregue por RUN.
• Una patente sin revisiones es una respuesta válida y cobra 1 crédito: «nunca ha pasado revisión técnica» es el dato que se vino a comprar. 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

• Ficha del vehículo chileno por patente vía API→
• Multas por patente en Chile y el permiso de circulación→
• Validar el SOAP chileno contra el registro de las aseguradoras→
• Revisión técnica en Perú: el CITV por placa→
• API de tecnomecánica Colombia: el equivalente por placa→
• Referencia del endpoint POST /api/revision-tecnica-cl→
• Todos los endpoints de Chile→