API del SIRNA: verificar la tarjeta profesional de un abogado por documento

PlacApi consulta el Registro Nacional de Abogados (SIRNA) de la Rama Judicial y devuelve en JSON si una persona está inscrita como abogado, su número de tarjeta profesional, la fecha de inscripción, el estado 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. Cuesta 1 crédito.

Probar en el sandbox y generar API keyVer precios por consulta

¿No eres desarrollador? Consulta el RUNT por placa aquí sin escribir código.

Qué problema resuelve

Un poder otorgado a quien no es abogado inscrito, o cuya tarjeta no está vigente, se cae en el proceso. La verificación de la tarjeta profesional se hace hoy a mano, abogado por abogado. Este endpoint la vuelve una llamada y entrega además el número del certificado, que deja constancia de cuándo se verificó.

Para quién sirve

Áreas jurídicas y de compras que contratan firmas de abogados, plataformas de servicios legales que dan de alta a sus abogados, aseguradoras y fintechs que reciben poderes, y entidades que validan a los apoderados de sus contrapartes.

Datos requeridos

  • docType — CC, CE o PPT. Por defecto CC.
  • docNumber — número de documento del abogado, hasta 10 dígitos.

Fuentes y cobertura

  • Rama Judicial — Registro Nacional de Abogados (SIRNA)Inscripción de los abogados, su tarjeta profesional y el estado de la tarjeta, con certificado de vigencia numerado.

¿Cuánto cuesta verificar un abogado por API?

1 crédito por consulta, y un «no inscrito» también se cobra. Una consulta servida de caché no cobra.

¿Cómo verificar la tarjeta profesional de un abogado por API?

Con un POST a /api/tarjeta-profesional-abogado enviando docType y docNumber. La respuesta trae la tarjeta, su estado y el certificado de vigencia.

Ejemplo de solicitud

POST https://placapi.com/api/tarjeta-profesional-abogado. Autenticación por API key en el header x-api-key. Los datos del ejemplo son ficticios.

Ejemplo cURL de la solicitud
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"}'

Parámetros, errores y ejemplos en cURL, JavaScript y Python: documentación de POST /api/tarjeta-profesional-abogado.

Ejemplo de respuesta

Respuesta JSON (fragmento con los campos de esta consulta; la API integral devuelve todas las fuentes en el mismo objeto).

Ejemplo de respuesta JSON
{
  "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",
    "certificado": {
      "numero": "1000001",
      "codigoVerificacion": "01234567…"
    }
  }
}

Explicación campo por campo

CampoTipoDescripción
inscritobooleantrue si la persona está inscrita como abogado. false es una respuesta válida y se cobra.
numeroTarjetastring | nullNúmero de la tarjeta profesional; null si solo tiene inscripción o licencia temporal.
vigenteboolean | nulltrue o false cuando el estado lo dice; null si no se reconoce o si el certificado trae observaciones.
certificadoobjectNúmero y código de verificación del certificado de vigencia expedido en la consulta; también viene en el «no inscrito» cuando el certificado los trae (null si no).

Tiempo de respuesta

~7 segundos: el registro expide un certificado firmado en cada consulta.

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, también para el «no inscrito»: cada consulta al registro emite un certificado, así que no se repite sin necesidad.

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

  • Consulta la calidad de abogado; no cubre jueces de paz ni licencias temporales como categoría aparte.
  • Documentos de hasta 10 dígitos, que es el tope del registro.
  • No reemplaza la consulta de antecedentes disciplinarios del abogado.

Códigos de error del endpoint (401, 402, 429, 5xx) en la referencia de errores.

Otras preguntas frecuentes

¿Por qué tarda más que otros endpoints?

+

Porque el registro expide un certificado firmado en cada consulta. Por eso la respuesta se guarda 7 días en caché.

Seguir explorando

Última revisión: 16 de octubre de 2026 · Versión de la API: v1 · Fuentes y metodología

Contacto