Endpoint: tarjeta profesional de contador público

Con el documento de una persona responde si 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 firmar con un revisor fiscal o un contador externo, o a aceptar estados financieros firmados por él. Un «no registra» es una respuesta válida y se cobra.

POST/api/tarjeta-profesional-contador1 crédito

Si una persona está inscrita como contador público, por documento: número de tarjeta profesional, nombre y estado de la inscripción (estado, p. ej. «ACTIVO»; vigente es el estado INFORMATIVO de la inscripción, true/false cuando el estado lo dice, null si no se reconoce, y no equivale al certificado de vigencia). Responde en ~1 s. El estado es el que publica el registro de forma informativa: la habilitación formal se acredita con el certificado de vigencia, que no se expide aquí. Un documento sin inscripción responde 200 con inscrito: false y COBRA. ⚠️ Solo CC, CE y PPT. Cuesta 1 crédito.

Para qué sirve, quién lo usa y cuánto cuesta: API Junta Central de Contadores.

Cuerpo de la solicitud

body (JSON)
{
  "docType": "CC",
  "docNumber": "1020304050"
}
Parámetros del cuerpo de la solicitud
CampoTipoQué es
docTypestringTipo de documento. Por defecto `CC`. Es el universo del registro; con otro valor responde 400 `bad_request` sin cobrar.Valores: CC · CE · PPT
docNumberobligatoriostringNúmero de documento, de 1 a 12 dígitos (se aceptan puntos y espacios). Alias aceptados: `doc`, `documento`.
refreshbooleanIgnora la caché y vuelve a consultar la fuente oficial. Ojo: una consulta refrescada con datos siempre cobra (el hit de caché no).

Ejemplos por lenguaje

cURL
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"}'
JavaScript (fetch)
const res = await fetch("https://placapi.com/api/tarjeta-profesional-contador", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"docType":"CC","docNumber":"1020304050"}),
});
const data = await res.json();
Python (requests)
import requests

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

Respuesta exitosa

200 OK — ejemplo (placas y documentos ficticios)
{
  "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,
    "fechaInscripcion": null,
    "profesionDetalle": "CONTADOR PÚBLICO",
    "certificado": null
  },
  "mode": "live",
  "fetchedAt": "2026-07-24T15:04:05.000Z",
  "cost": 1
}

Errores y cobro

Cuesta 1 crédito 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.

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

Contacto