API de procesos judiciales de la Rama Judicial: por radicado o por nombre

Qué problema resuelve

Saber si una persona o una empresa tiene procesos judiciales abiertos es parte de cualquier estudio de contraparte, y la consulta oficial se hace de a un radicado por vez en un portal web. Además, la fuente entrega a todas las partes en una sola cadena de texto separada por barras, así que quien integra termina escribiendo su propio partidor —y equivocándose con los nombres de entidades que llevan dos puntos—. Este endpoint hace ese trabajo y devuelve rol y nombre por separado.

Para quién sirve

Áreas de riesgo y cumplimiento, firmas de abogados que monitorean expedientes, plataformas de originación de crédito, y equipos de selección que verifican una contraparte antes de vincularla.

Datos requeridos

• radicado — número de 23 dígitos del proceso. Los guiones y espacios se ignoran.
• nombre — alternativa: nombre o razón social de una de las partes.
• tipoPersona — nat o jur. Solo aplica con nombre y por defecto es nat.
• soloActivos — opcional. Por defecto vienen todos, incluidos los terminados.

Fuentes y cobertura

• Rama Judicial de Colombia — Consulta de Procesos Nacional UnificadaProcesos de los despachos del país: radicado, despacho, departamento, fechas, partes procesales, ponente, tipo y clase de proceso, ubicación del expediente y actuaciones con su anotación.

¿Cómo consultar un proceso judicial por radicado desde una API?

Con una llamada POST a /api/rama-judicial enviando el campo radicado con los 23 dígitos. La respuesta trae el despacho, las partes separadas por rol, el detalle del proceso y sus últimas actuaciones con la anotación del juzgado.

¿Se pueden buscar los procesos de una persona por su nombre?

Sí, con el campo nombre y tipoPersona en nat para persona natural o jur para empresa. Hay que indicar cuál: la fuente consulta las dos por separado y pedir una empresa como persona natural devuelve vacío sin avisar.

Ejemplo de solicitud

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

curl -X POST 'https://placapi.com/api/rama-judicial' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"radicado":"11001310300320210012300"}'

Ejemplo de respuesta

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

{
  "source": "procesos-judiciales",
  "status": "info",
  "data": {
    "resumen": {
      "tieneProcesos": true,
      "totalProcesos": 1
    },
    "procesos": [
      {
        "radicado": "11001310300320210012300",
        "fechaRadicacion": "2021-03-25",
        "despacho": "JUZGADO 003 CIVIL DEL CIRCUITO DE BOGOTÁ",
        "esPrivado": false,
        "partes": [
          {
            "rol": "Demandante",
            "nombre": "JUAN PEREZ GOMEZ"
          },
          {
            "rol": "Demandado",
            "nombre": "ENTIDAD DE EJEMPLO"
          }
        ],
        "detalle": {
          "tipoProceso": "Acción de Tutela",
          "claseProceso": "Tutelas",
          "ubicacion": "Secretaria - Oficios"
        },
        "actuaciones": [
          {
            "fecha": "2021-04-12",
            "actuacion": "Sentencia tutela primera Instancia",
            "anotacion": "CONCEDE"
          }
        ],
        "totalActuaciones": 7
      }
    ]
  }
}

Explicación campo por campo

Limitaciones y posibles errores

• Tener procesos judiciales NO es una condena ni un antecedente. La lista incluye tutelas, procesos terminados hace años y casos donde la persona es quien demanda. Por eso el semáforo nunca marca peligro y hay que leer las partes y el estado.
• Buscar por nombre exige distinguir persona natural de jurídica: la fuente no busca en las dos a la vez, y pedir una empresa como natural devuelve vacío en silencio.
• Si la búsqueda por nombre arroja más de mil procesos, la fuente la rechaza y hay que acotarla. Se responde 400 con el código consulta_invalida, no un error genérico.
• Un radicado que no existe responde 404 y NO cobra: es un número mal escrito, no un veredicto sobre nadie.
• Los procesos reservados aparecen marcados pero sin partes ni actuaciones.

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

Otras preguntas frecuentes

Seguir explorando

• API de antecedentes judiciales→
• API del SECOP II: contratos con el Estado→
• API del RUES: registro mercantil→
• API de nombre por cédula→
• Documentación e integración→