Endpoint: tarjeta profesional de abogado (SIRNA)

Con el documento de una persona responde si está inscrita como abogado en el Registro Nacional de Abogados (SIRNA) de la Rama Judicial, con su tarjeta profesional, el estado de la inscripción y el número y código de verificación del certificado de vigencia que se expide en la consulta. Sirve para validar a un apoderado antes de otorgarle un poder o de contratarlo. Un «no está inscrito» es una respuesta válida y se cobra.

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

Si una persona está inscrita como abogado, por documento: número de tarjeta profesional, fecha de inscripción, estado (estado, p. ej. «VIGENTE»; vigente true/false cuando el estado lo dice, null si no se reconoce o si el certificado trae observaciones) y el número y código de verificación del certificado de vigencia que se expide en la consulta (también en el negativo, que deja constancia de cuándo se verificó). Responde en ~7 s y se guarda 7 días en caché, también el negativo. Un documento sin inscripción responde 200 con inscrito: false y COBRA. ⚠️ Solo CC, CE y PPT, hasta 10 dígitos. Cuesta 1 crédito.

Para qué sirve, quién lo usa y cuánto cuesta: API tarjeta profesional de abogado.

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`. Con otro valor responde 400 `bad_request` sin cobrar.Valores: CC · CE · PPT
docNumberobligatoriostringNúmero de documento, de 1 a 10 dígitos (es el tope del registro; 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-abogado' \
  -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-abogado", {
  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-abogado",
    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": "abogado",
    "documento": "1020304050",
    "tipoDocumento": "CC",
    "inscrito": true,
    "nombre": "JUAN CARLOS PEREZ GOMEZ",
    "numeroTarjeta": "123456",
    "estado": "VIGENTE",
    "vigente": true,
    "fechaInscripcion": "2005-03-15",
    "profesionDetalle": "ABOGADO(A) INSCRITO(A)",
    "certificado": {
      "numero": "1000001",
      "codigoVerificacion": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
    }
  },
  "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