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
AutenticaciónAPI keys, header x-api-key y cómo generarlas.Errores y rate limits401, 402, 422, 429, 5xx y política de reintentos.
Vehículo por placa
Todo lo que se responde con la placa y el documento del propietario.
POST /api/consulta-fullRecomendada · 2 créditosTodo el conjunto de fuentes en UNA sola llamada: bundle vehicular completo (RUNT, SOAT, tecnomecánica, antecedentes, multas SIMIT, impuesto, avalúo FASECOLDA 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/avaluoValor comercial FASECOLDA y rango de mercado por placa: código FASECOLDA, marca, línea, modelo (año), valor comercial en pesos, rango min/max y clase.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/impuestosDepartamento donde está matriculado el vehículo y enlace al portal oficial de impuestos.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: total adeudado en pesos, número de multas, el detalle de cada una (fecha, organismo, infracción, código, estado pendiente/acuerdo/pagada y valor) y cuántos acuerdos de pago hay. status: ok sin multas, warn con multas y danger si la deuda pasa de $1.000.000.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. status: ok sin acuerdos, warn con al menos uno.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/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-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/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.
Fuera de Colombia
Mismo contrato de trece campos, con un bloque de cobertura que dice cuáles no publica cada registro.
Guías
Consulta masiva de placasGuíaConcurrencia, qué reintentar, el tope de 1.000 por minuto y cuánto cuesta un lote de 1.000, 5.000 o 50.000 placas.Verificación de identidadGuíaLas once consultas sobre personas y empresas, qué documento pide cada una, qué cuesta y qué NO alcanza a verificar.
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.