API de antecedentes fiscales de la Contraloría por documento
PlacApi consulta el Boletín de Responsables Fiscales (SIBOR) de la Contraloría General de la República y devuelve en JSON si una persona está reportada como responsable fiscal, junto con el código con el que se comprueba la autenticidad del certificado ante la entidad. Estar en ese boletín inhabilita para contratar con el Estado y para posesionarse en cargos públicos, así que es un requisito de verificación, no un dato accesorio.
¿No eres desarrollador? Consulta el RUNT por placa aquí sin escribir código.
Qué problema resuelve
El certificado de antecedentes fiscales es obligatorio para contratar con el Estado y para posesionar a alguien en un cargo público, y se expide como PDF desde un portal. Automatizar esa verificación dentro de un flujo de vinculación obliga a descargar y leer documentos uno por uno. Este endpoint devuelve el veredicto y el código de verificación como campos.
Para quién sirve
Entidades públicas y contratistas del Estado, áreas de cumplimiento y talento humano, y cualquier plataforma que verifique requisitos de contratación pública.
Datos requeridos
- docType — tipo de documento (CC, CE, TI, PA, PPT o PEP).
- docNumber — número de documento.
Fuentes y cobertura
- Contraloría General de la República — Boletín de Responsables Fiscales (SIBOR)Certificado que indica si la persona figura reportada como responsable fiscal, con su código de verificación y la fecha de la consulta.
¿Cómo consultar los antecedentes fiscales por API?
Con una llamada POST a /api/antecedentes-fiscales enviando docType y docNumber. La respuesta trae en JSON si la persona está reportada como responsable fiscal y el código con el que se verifica el certificado ante la Contraloría.
¿Qué significa estar en el Boletín de Responsables Fiscales?
Que la Contraloría declaró a esa persona responsable fiscal por un detrimento al patrimonio público. Mientras figure ahí queda inhabilitada para contratar con el Estado y para posesionarse en cargos públicos.
Ejemplo de solicitud
POST https://placapi.com/api/antecedentes-fiscales. Autenticación por API key en el header x-api-key. Los datos del ejemplo son ficticios.
curl -X POST 'https://placapi.com/api/antecedentes-fiscales' \
-H 'x-api-key: pk_live_TU_CLAVE' \
-H 'content-type: application/json' \
-d '{"docType":"CC","docNumber":"1020304050"}'Ejemplo de respuesta
Respuesta JSON (fragmento con los campos de esta consulta; la API integral devuelve todas las fuentes en el mismo objeto).
{
"source": "antecedentes-fiscales",
"status": "ok",
"data": {
"documento": "1020304050",
"tipoDocumento": "Cédula de Ciudadanía",
"tieneAntecedentes": false,
"descripcion": "No se encuentra reportado como responsable fiscal",
"codigoVerificacion": "1020304050260811171708",
"fechaConsulta": "martes 11 de agosto de 2026 17:17:08"
}
}Explicación campo por campo
| Campo | Tipo | Descripción |
|---|---|---|
| tieneAntecedentes | boolean | true si la persona figura en el Boletín de Responsables Fiscales. |
| codigoVerificacion | string | Código con el que se comprueba la autenticidad del certificado ante la Contraloría. Es lo que permite auditar la consulta después. |
| fechaConsulta | string | Momento en que la entidad expidió el certificado, tal como lo escribe el portal. |
| descripcion | string | La leyenda textual del certificado, lista para mostrar. |
Tiempo de respuesta
Alrededor de medio minuto.
Precio y cobro
1 crédito por consulta con datos, desde 349 COP. El precio por crédito baja por volumen: 349 COP desde 30, 249 COP desde 1.000, 149 COP desde 5.000, 139 COP desde 10.000, 119 COP desde 20.000, 99 COP desde 50.000. Los créditos se compran por adelantado (mínimo 30 = 10.470 COP), no vencen y no hay mensualidad. El mismo precio aplica por la web y por API. Solo se cobra cuando la consulta devuelve datos; por API, las consultas sin resultado (404) tienen 10 gratis al mes por cada tipo de respuesta sin datos y después cobran igual.
Caché y actualización
24 horas, igual que el resto de los antecedentes de persona.
Seguridad y privacidad
La placa y el documento se usan solo para ejecutar la consulta; el resultado queda en caché temporal. No se almacenan datos de tarjetas (los pagos los procesa Wompi). Ver privacidad y seguridad.
Limitaciones y posibles errores
- Una respuesta "no está reportado" COBRA: es el dato que se vino a comprobar.
- 🔴 Conviene saberlo: este portal expide un certificado de "sin antecedentes" incluso para documentos que NO existen. La respuesta dice lo que dice la fuente, pero no confirma que la persona exista — para eso está /api-cedula-colombia.
- Cubre personas naturales. Con NIT, CD o RC responde 400 sin cobrar.
- Estar reportado inhabilita para contratar con el Estado, pero la decisión de vinculación es de quien consulta: la API entrega el dato oficial, no el veredicto.
Códigos de error del endpoint (401, 402, 429, 5xx) en la referencia de errores.
Otras preguntas frecuentes
¿El certificado sirve para un proceso de contratación?
+
La API devuelve el mismo veredicto y el código de verificación del certificado oficial, que es lo que permite comprobarlo ante la entidad. Si el proceso exige el PDF firmado, ese hay que descargarlo del portal de la Contraloría.
¿Un "sin antecedentes" garantiza que la persona existe?
+
No, y conviene saberlo: el portal expide ese certificado incluso para documentos inexistentes. Si necesitas confirmar que el documento corresponde a una persona real, la consulta de identidad lo resuelve.
Seguir explorando
Última revisión: 20 de agosto de 2026 · Versión de la API: v1 · Fuentes y metodología