Documentación de la API

PlacApi expone una API REST en https://placapi.com/api. Autenticación por API key, cuerpos y respuestas en JSON, y el mismo precio por consulta que la web. Empieza por autenticación y luego elige el endpoint.

Empezar

Vehículo por placa

Todo lo que se responde con la placa y el documento del propietario.

POST /api/consulta-fullRecomendada · 3 créditosTodo el conjunto de fuentes en UNA sola llamada: bundle vehicular completo (RUNT, SOAT, tecnomecánica, antecedentes, multas SIMIT, impuesto, avalúo FASECOLDA —con fichaTecnica de 38 campos y origen— y pico y placa) MÁS la licencia de conducción del propietario (por la misma cédula).POST /api/consultaFicha completa del RUNT por placa: informacionGeneral (≈40 campos del vehículo), datosTecnicos, histórico completo de SOAT y de tecnomecánica (todas las vigencias, no solo la última), pólizas de responsabilidad civil, tarjeta de operación, blindaje, solicitudes, garantías mobiliarias, limitaciones a la propiedad y normalización.POST /api/vehiculo-basicoProyección liviana de la ficha del RUNT por placa: exactamente 12 campos — placa, marca, línea, modelo, cilindraje, color, clase, servicio, combustible, estado, fecha de matrícula y organismo de tránsito.POST /api/consulta-por-vinLa MISMA ficha del RUNT que /api/consulta —informacionGeneral, datosTecnicos, histórico completo de SOAT y tecnomecánica, pólizas, solicitudes, garantías, limitaciones y normalización— pero entrando por VIN en vez de placa, y sin documento del propietario.POST /api/apto-traspasoSemáforo SÍ/NO de si un vehículo está apto para traspaso, derivado del RUNT: sin gravámenes, prendas, limitaciones a la propiedad ni garantías, y con el registro activo.POST /api/garantias-rgmPrendas inscritas sobre un vehículo en el RGM de Confecámaras, por placa.POST /api/perdida-total2 créditosHistorial de reclamaciones ante aseguradoras de un vehículo (fuente FASECOLDA, desde 2008): fecha, amparo y severidad de cada registro.POST /api/accidentes-bogotaAccidentes de tránsito registrados por la autoridad de movilidad de Bogotá (informes IPAT) de un vehículo, por placa: fecha, gravedad (SOLO DAÑOS, CON HERIDOS, CON MUERTOS), número de formulario y código del informe, más recientes primero, con gravedadMaxima como resumen.POST /api/reporte-hurtoDenuncias de hurto y demás procesos penales en los que quedó vinculado un vehículo, solo con la placa.POST /api/avaluoValor comercial FASECOLDA por placa: código FASECOLDA, marca, línea, modelo (año), valor comercial en pesos, clase y la ficha técnica completa en fichaTecnica (38 campos: motor, dimensiones, capacidades, seguridad, equipamiento y clasificación — los mismos de /api/avaluo-por-codigo).POST /api/avaluo-por-vinValor comercial FASECOLDA y ficha técnica completa por VIN (número de chasis), sin placa ni documento del propietario.POST /api/avaluo-por-codigoValor comercial FASECOLDA directo por código, sin resolver placa→código.POST /api/catalogoMarcas, modelos, referencias y versiones de vehículos en Colombia, en cascada para poblar un selector: sin filtros trae las marcas y los años; con marca, sus referencias; con marca + modelo (o + referencia), las versiones.POST /api/impuestos2 créditosEstado del impuesto vehicular por departamento.POST /api/pico-y-placaRestricción de pico y placa por ubicación y tipo de vehículo.

Multas, comparendos y licencia

La deuda de tránsito y el estado del conductor. Por placa o por cédula, según lo que consolide la fuente.

POST /api/multasComparendos y deuda del SIMIT consolidados por placa + documento: une las multas del vehículo con las del documento enviado (también las de otras placas de esa persona, que le bloquean trámites como el traspaso), sin repetir ninguna.POST /api/comparendosComparendos de una persona por cédula (fuente SIMIT): lista tipada con fecha, organismo, infracción, código, estado, valor y departamento de cada comparendo, más el total adeudado.POST /api/comparendoDetalle de un comparendo puntual: se busca por su número dentro de los comparendos de la persona (cédula) y se devuelve el item completo (fecha, organismo, infracción, código, estado, valor, departamento) o encontrado: false con comparendo: null si no figura.POST /api/acuerdos-pagoAcuerdos de pago de comparendos de una persona por cédula (fuente SIMIT): resolución, fecha, estado, valor del acuerdo, saldo pendiente, secretaría y departamento de cada uno, más el total pendiente.POST /api/resolucionesResoluciones sancionatorias asociadas a una persona por cédula (fuente SIMIT): las multas que ya tienen número de resolución, con fecha, organismo, infracción, código, estado, valor y departamento, más el total adeudado. status: ok sin resoluciones, warn con al menos una y danger si el total pasa de $1.000.000.POST /api/estado-cuenta-transito2 créditosToda la deuda de tránsito de una persona por cédula (fuente SIMIT) en una sola respuesta: sus comparendos, sus resoluciones sancionatorias —las multas en firme— y sus acuerdos de pago, cada bloque con su conteo, su subtotal y el detalle de cada ítem en la misma forma que entregan /api/comparendos, /api/resoluciones y /api/acuerdos-pago.POST /api/paz-salvoCertificado de paz y salvo de tránsito de una persona por cédula (fuente SIMIT): indica si está a paz y salvo (sin comparendos ni deuda pendiente), el total adeudado y la cantidad de comparendos. status es ok a paz y salvo, warn si no.POST /api/licenciaLicencias de conducción por cédula (RUNT ciudadano): datos del conductor (nombre, estado de conductor y de ciudadano, número y fecha de inscripción), el arreglo licenses con una entrada por categoría —categoría, estado, número, organismo que expide, expedición, vencimiento, restricciones y, si aplica, resolución y fechas de suspensión— y los bloques de infracciones, solicitudes, certificados de aptitud y médicos, trámites SICOV, pagos ANSV, validaciones de identidad e impuestos de tránsito.POST /api/suspension-licenciaEstado de suspensión o cancelación de la licencia de conducción de una persona por cédula (fuente SIMIT): banderas suspendida/cancelada y, cuando aplica, la vigencia de la medida (fecha desde, fecha hasta y organismo de tránsito); sin medida los tres campos vienen null. status es danger si está suspendida o cancelada, ok si no.

Personas y empresas

Verificación por documento o por nombre: identidad, antecedentes, situación social y actividad con el Estado.

POST /api/cedulaNombre completo del titular de un documento de identidad.POST /api/antecedentes-judiciales2 créditosAntecedentes judiciales de una persona por documento, del sistema de la Policía Nacional.POST /api/antecedentes-rnmcMedidas correctivas pendientes por cumplir de una persona, del Registro Nacional de Medidas Correctivas (RNMC) creado por la Ley 1801 de 2016, el Código Nacional de Seguridad y Convivencia Ciudadana.POST /api/antecedentes-disciplinariosAntecedentes disciplinarios de una persona por documento, del sistema SIRI de la Procuraduría General de la Nación.POST /api/antecedentes-fiscalesAntecedentes fiscales de una persona natural por documento, del Boletín de Responsables Fiscales (SIBOR) de la Contraloría General de la República.POST /api/listas-restrictivasBúsqueda de una persona o empresa en las listas de sanciones de OFAC (Departamento del Tesoro de EE.POST /api/rama-judicialProcesos judiciales de la Consulta de Procesos Nacional Unificada de la Rama Judicial.POST /api/sisbenClasificación socioeconómica de una persona por documento, de la Ventanilla Social del DNP.POST /api/ruiGrupo del Registro Universal de Ingresos (RUI) de una persona por documento, de la Ventanilla Social del DNP: el nivel y el grupo de ingresos con los que hoy se decide el acceso a programas sociales.POST /api/ruaf2 créditosTodas las afiliaciones de una persona al sistema de seguridad social, del RUAF del Ministerio de Salud, en UNA llamada: salud (EPS, régimen, tipo de afiliado y estado), pensiones (fondo y régimen), riesgos laborales (ARL), caja de compensación, cesantías, si está pensionada y a qué programas de asistencia social está vinculada.POST /api/epsLa afiliación en salud de una persona por documento, de la Base de Datos Única de Afiliados (BDUA) que administra la ADRES: la EPS, el régimen (contributivo o subsidiado), el estado (activo/retirado), el tipo de afiliado (cotizante, beneficiario, cabeza de familia) y las fechas de afiliación y finalización, junto con los datos básicos de la persona y su ciudad.POST /api/rethusLa inscripción de una persona en el Registro Único Nacional del Talento Humano en Salud (RETHUS) de MinSalud, por documento, sin fecha de expedición.POST /api/arl-suraLa afiliación a riesgos laborales de una persona en la ARL SURA —la administradora más grande del país— por documento, sin fecha de expedición.POST /api/ruesEmpresas y comerciantes inscritos en las Cámaras de Comercio (el registro que el público consulta como "RUES").POST /api/secopContratos de una persona o una empresa con el Estado colombiano, del SECOP II de Colombia Compra Eficiente.POST /api/sigepDeclaraciones de bienes y rentas y conflicto de interés (Ley 2013 de 2019) de servidores públicos y contratistas del Estado, del buscador ciudadano de la Función Pública.POST /api/puesto-votacionDónde le toca votar a una persona, por cédula, del censo electoral de la Registraduría.POST /api/telefonoLa fecha probable de creación de una línea móvil colombiana.POST /api/correoLa fecha probable de creación de un correo.

Certificados en PDF

Disciplinarios, fiscales, judiciales, OFAC y ONU en una llamada, cada uno con su PDF: el original de la entidad cuando lo expide y una constancia de PlacApi cuando no.

Fuera de Colombia

Mismo contrato de trece campos, con un bloque de cobertura que dice cuáles no publica cada registro.

POST /api/vehiculo-peFicha técnica de un vehículo peruano por placa, desde el registro oficial de propiedad vehicular.POST /api/revision-tecnica-peCertificados de inspección técnica vehicular (CITV) de un vehículo peruano por placa: el equivalente a la tecnomecánica.POST /api/soat-peSOAT (seguro obligatorio de accidentes de tránsito) de un vehículo peruano por placa, desde el registro central de las aseguradoras.POST /api/multas-pePapeletas de tránsito PENDIENTES de un vehículo peruano por placa, unidas de tres registros: el récord nacional de infracciones en carreteras (origen: "nacional"), las papeletas de Lima Metropolitana (origen: "lima") y las de la Provincia Constitucional del Callao (origen: "callao").POST /api/licencia-peRécord del conductor peruano por documento: licencias de conducir con número, clase y categoría, estado (VIGENTE o compuestos como CANCELADA/CONDUCTOR INHABILITADO), fechas de expedición y revalidación y restricciones, más las sanciones (resolución, fechas de inicio y fin, y estado derivado de esas fechas).POST /api/vehiculo-clFicha de un vehículo chileno por patente, con el mismo contrato de trece campos que Perú y México.POST /api/revision-tecnica-clRevisión técnica de un vehículo chileno por patente, desde la base central que consolida todas las Plantas de Revisión Técnica del país.POST /api/soap-clValida el SOAP (seguro obligatorio) de un vehículo chileno contra el registro de las aseguradoras.POST /api/multas-clMultas de tránsito de un vehículo chileno por patente, unidas de tres registros: el detalle con importes de los Juzgados de Policía Local de todo el país (origen: "detalle"), el consolidado nacional de multas no pagadas (origen: "nacional") y las infracciones detectadas por cámaras en los últimos 60 días, que todavía no llegan al juzgado (origen: "camaras").POST /api/multas-mxMultas de tránsito y sanciones de un vehículo de la Ciudad de México por placa, desde la consulta pública de adeudos de la Secretaría de Administración y Finanzas de la CDMX.POST /api/verificacion-mxVerificación vehicular de la Ciudad de México por placa: el equivalente mexicano de la tecnomecánica.POST /api/licencia-mxVigencia de la licencia de conducir de la Ciudad de México por CURP, desde el portal de finanzas de la CDMX.

Guías

Autenticación y CORS

La autenticación es por API key en el header x-api-key (detalle en autenticación). No hay OAuth ni claves por query string.

CORS no está habilitado: ninguna respuesta de https://placapi.com/api incluye Access-Control-Allow-Origin, así que un fetch desde el JavaScript de una página web lo bloquea el navegador. La API es servidor a servidor.

Es una decisión de seguridad, no una limitación pendiente. Para llamar desde el navegador habría que poner la API key en el código que se descarga el visitante, y ahí la ve cualquiera que abra las herramientas de desarrollo: la pestaña Red muestra el header completo. Una key expuesta la puede usar un tercero y el consumo se descuenta de tus créditos. Habilitar CORS sería invitar a eso.

La integración correcta es llamarnos desde tu backend con la key guardada como variable de entorno, y que tu frontend hable con tu propio endpoint. Así también controlas tú quién consulta y cuántas veces.

Especificación

Especificación legible por máquina en /openapi.json (OpenAPI 3.1), colección de Postman e índice APIs.json. Prueba las llamadas en vivo desde el sandbox y consulta las fuentes y metodología.

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

Contacto