Endpoint: certificado de tecnomecánica en PDF

Con la placa y el documento del propietario, /api/certificado-tecnomecanica entrega el certificado de la última revisión técnico-mecánica y de emisiones contaminantes del vehículo: el PDF original que expidió el CDA, en base64 dentro del JSON y como enlace de descarga.

POST/api/certificado-tecnomecanica2 créditos

El certificado de la revisión técnico-mecánica y de emisiones contaminantes en PDF, el original que expide el CDA y queda en el registro, con la placa y el documento del propietario. Es el documento de la última revisión del vehículo: llega con sus datos en tecnoMecanica (los mismos campos que en Consulta vehicular) y el archivo en pdf, de dos formas a la vez: pdf.base64 dentro del JSON y pdf.url, un enlace de 72 horas. Los dos son los mismos bytes que entregó el registro, sin regenerar ni recomprimir; pdf.sha256 permite comprobarlo. 2 créditos, y solo si llega el PDF. Si el vehículo no tiene revisión registrada, o el registro no tiene el PDF de la última (pasa en una de cada quince, más o menos), la respuesta es 404 certificado_no_disponible y no cobra. Responde en unos 5 segundos. El SOAT, las pólizas de responsabilidad civil y la tarjeta de operación no tienen PDF en el registro: sus datos vienen en Consulta vehicular.

Cuerpo de la solicitud

body (JSON)
{
  "placa": "ABC123",
  "docType": "CC",
  "docNumber": "1020304050"
}
Parámetros del cuerpo de la solicitud
CampoTipoQué es
placaobligatoriostringPlaca del vehículo. 5 a 7 caracteres alfanuméricos: cubre AAA000, AAA00A y los formatos menos comunes (AAA00, AAAA00). Los guiones y espacios se ignoran. Si la mandas dentro del alias interno de tu flota (`ABC12D_JPG`, `ABC12D-JUAN-PEREZ`, `ABC12D-MOVIL-11`) se extrae la placa, siempre que en el texto haya UNA sola: con dos o con ninguna la respuesta es 400.
docTypeobligatoriostringTipo de documento del propietario (CC, CE, NIT, PA, TI, CD, PPT, RC). Se aceptan alias comunes: PAS y PASAPORTE se normalizan a PA, y P.P.T. y P.P. —como lo abrevia la tarjeta de propiedad— se normalizan a PPT.Valores: CC · CE · NIT · PA · TI · CD · PPT · RC
docNumberobligatoriostringNúmero de documento del propietario. Alias aceptado: `doc`. Si el vehículo tiene traspaso a persona indeterminada, manda `docNumber` 1111111111.

Ejemplos por lenguaje

cURL
curl -X POST 'https://placapi.com/api/certificado-tecnomecanica' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"placa":"ABC123","docType":"CC","docNumber":"1020304050"}'
JavaScript (fetch)
const res = await fetch("https://placapi.com/api/certificado-tecnomecanica", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"placa":"ABC123","docType":"CC","docNumber":"1020304050"}),
});
const data = await res.json();
Python (requests)
import requests

res = requests.post(
    "https://placapi.com/api/certificado-tecnomecanica",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"placa":"ABC123","docType":"CC","docNumber":"1020304050"},
)
data = res.json()

Respuesta exitosa

200 OK — ejemplo (placas y documentos ficticios)
{
  "source": "certificado-tecnomecanica",
  "status": "ok",
  "placa": "ABC123",
  "tecnoMecanica": {
    "cdaExpide": "CDA FONTIBON S.A.S",
    "estado": "APROBADA",
    "fechaExpedicion": "22/09/2025",
    "fechaVencimiento": "22/09/2026",
    "informacionConsistente": "SI",
    "nroCertificado": "189733821",
    "numeroPlaca": "ABC123",
    "tipoRevision": "REVISION PERIODICA",
    "vigente": "SI"
  },
  "fetchedAt": "2026-07-24T15:04:05.000Z",
  "mode": "live",
  "cost": 2,
  "pdf": {
    "tipo": "oficial",
    "url": "https://placapi.com/api/certificados/Pq7wE2rT5yU8iO1aS4dF7gH0jK3lZ6xC",
    "expiraEn": "2026-07-27T15:04:05.000Z",
    "nombreArchivo": "certificado-tecnomecanica-ABC123-189733821.pdf",
    "bytes": 481920,
    "sha256": "7d1e4a9c2b5f8e3a6d0c9b2e5f8a1d4c7b0e3f6a9d2c5b8e1f4a7d0c3b6e9f2a",
    "contentType": "application/pdf",
    "base64": "JVBERi0xLjUKJeLjz9MKMSAwIG9iago8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFI+PgplbmRvYmoK…"
  }
}

Errores y cobro

Cuesta 2 créditos cuando devuelve datos. Códigos posibles: 400 401 402 404 429 500 502 — qué significa cada uno, cuál reintentar y cuál cobra, en errores y rate limits. Autenticación por x-api-key: cómo generar la clave.

¿Cómo llega el PDF?

De dos formas en la misma respuesta. pdf.base64 trae el archivo completo codificado en base64: decodifícalo y guárdalo como .pdf, sin otra llamada. pdf.url lo abre en el navegador; agregándole ?descargar=1 lo baja con el nombre de pdf.nombreArchivo. El enlace no pide API key, así que puedes entregárselo a tu usuario final, y deja de funcionar en pdf.expiraEn (72 horas).

Es el documento original, pdf.tipo: "oficial": los mismos bytes que guarda el registro, sin regenerarlo ni recomprimirlo. pdf.sha256 sirve para comprobar que lo que guardaste es lo que se entregó, y pdf.bytes dice su tamaño (alrededor de 480 KB, una página). El pdf va al final del JSON a propósito: si tu cliente registra las respuestas, los datos de la revisión quedan primero.

¿De qué revisión es el certificado?

De la última que tiene registrada el vehículo, y sus datos llegan en tecnoMecanica con los mismos campos que en Consulta vehicular: número de certificado, CDA, fechas de expedición y vencimiento, estado y si está vigente. Si la última revisión ya venció, status llega en "warn" y tecnoMecanica.vigente en "NO": el PDF se entrega igual, porque es el último que existe. Nunca se entrega el certificado de una revisión anterior en lugar del de la última.

Solo la tecnomecánica tiene documento descargable. El SOAT, las pólizas de responsabilidad civil y la tarjeta de operación no tienen PDF en el registro: sus datos vienen en Consulta vehicular.

¿Cuánto cuesta y qué pasa si no hay certificado?

2 créditos, y solo cuando llega el PDF. No cobra si el vehículo no tiene revisión registrada (un vehículo nuevo que aún no la necesita) ni si el registro no tiene el PDF de la última revisión, que pasa más o menos en una de cada quince: los dos casos responden 404 con code: "certificado_no_disponible". Un documento que no es del propietario o un vehículo que no está registrado responden 404 con su propio code y siguen la misma regla de las consultas sin resultado que la consulta vehicular. Si el registro no responde, es 502 y no cobra.

Responde en unos 5 segundos. No hay caché: cada llamada pide el certificado de nuevo.

Última revisión: 17 de octubre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.

Contacto