API de la Junta Central de Contadores: verificar un contador público por documento
PlacApi responde en JSON, en ~1 segundo, si una persona está inscrita como contador público ante la Junta Central de Contadores, con su número de tarjeta profesional y el estado de la inscripción. Es la verificación previa a nombrar un revisor fiscal, contratar un contador externo o aceptar estados financieros firmados por él. Cuesta 1 crédito, y un «no registra» también se cobra porque es el dato que se viene a buscar.
¿No eres desarrollador? Consulta el RUNT por placa aquí sin escribir código.
Qué problema resuelve
Una firma de contador público da fe pública sobre los estados financieros de una empresa, y quien los recibe —un banco, un comprador, una entidad pública— casi nunca comprueba que el firmante esté inscrito. La verificación es manual, una persona a la vez. Este endpoint la vuelve una llamada que se puede meter en el flujo de originación de crédito o de alta de proveedores.
Para quién sirve
Bancos y fintechs que reciben estados financieros con su dictamen, áreas de compras que dan de alta firmas de auditoría y revisoría fiscal, plataformas de contratación de servicios profesionales y equipos de cumplimiento.
Datos requeridos
- docType — CC, CE o PPT. Por defecto CC.
- docNumber — número de documento del contador.
Fuentes y cobertura
- UAE Junta Central de ContadoresRegistro de los contadores públicos inscritos, con su tarjeta profesional y el estado de la inscripción.
¿Cuánto cuesta verificar un contador por API?
1 crédito por consulta, y un «no registra» también se cobra. Una consulta servida de caché no cobra.
¿Cómo saber por API si un contador público está inscrito?
Con un POST a /api/tarjeta-profesional-contador enviando docType y docNumber. inscrito dice si está en el registro y estado en qué situación está su inscripción.
Ejemplo de solicitud
POST https://placapi.com/api/tarjeta-profesional-contador. Autenticación por API key en el header x-api-key. Los datos del ejemplo son ficticios.
curl -X POST 'https://placapi.com/api/tarjeta-profesional-contador' \
-H 'x-api-key: pk_live_TU_CLAVE' \
-H 'content-type: application/json' \
-d '{"docType":"CC","docNumber":"1020304050"}'Parámetros, errores y ejemplos en cURL, JavaScript y Python: documentación de POST /api/tarjeta-profesional-contador.
Ejemplo de respuesta
Respuesta JSON (fragmento con los campos de esta consulta; la API integral devuelve todas las fuentes en el mismo objeto).
{
"source": "tarjeta-profesional",
"status": "ok",
"data": {
"profesion": "contador",
"documento": "1020304050",
"tipoDocumento": "CC",
"inscrito": true,
"nombre": "JUAN CARLOS PEREZ GOMEZ",
"numeroTarjeta": "T-123456",
"estado": "ACTIVO",
"vigente": true
}
}Explicación campo por campo
| Campo | Tipo | Descripción |
|---|---|---|
| inscrito | boolean | true si la persona está inscrita como contador público. false es una respuesta válida y se cobra. |
| numeroTarjeta | string | Número de la tarjeta profesional. |
| estado | string | Estado de la inscripción tal como lo publica el registro (p. ej. ACTIVO). |
| vigente | boolean | null | Estado INFORMATIVO de la inscripción, no equivale al certificado de vigencia: true o false cuando el estado lo dice; null si el estado no se reconoce (en ese caso leer estado). |
Tiempo de respuesta
~1 segundo.
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. Por la web, el informe completo por placa cuesta 3 créditos. 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
7 días cuando la persona está inscrita; 1 hora cuando no, para que un documento mal digitado no herede el «no registra».
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
- El estado que publica el registro es informativo: la habilitación formal de un contador se acredita con su certificado de vigencia, que este endpoint no expide.
- No incluye las sanciones disciplinarias del ejercicio profesional.
- Solo CC, CE y PPT.
Códigos de error del endpoint (401, 402, 429, 5xx) en la referencia de errores.
Otras preguntas frecuentes
¿Sirve para verificar a un revisor fiscal?
+
Sí: el revisor fiscal tiene que ser contador público inscrito, y esa es la inscripción que se consulta.
Seguir explorando
Última revisión: 16 de octubre de 2026 · Versión de la API: v1 · Fuentes y metodología