Endpoint: procesos judiciales (Rama Judicial)

Consulta la base de Procesos Nacional Unificada de la Rama Judicial por radicado de 23 dígitos o por el nombre de una de las partes, indicando si es persona natural o jurídica. Devuelve despacho, departamento, fechas y las partes procesales ya separadas por rol, que la fuente entrega en un solo texto plano. Buscando por radicado agrega el detalle del proceso y las últimas actuaciones con su anotación, que es lo que responde en qué va el proceso y no solo si existe.

POST/api/rama-judicial1 crédito

Procesos judiciales de la Consulta de Procesos Nacional Unificada de la Rama Judicial. Se busca por `radicado` (23 dígitos) o por `nombre` de una de las partes, indicando si es persona natural o jurídica. Devuelve despacho, departamento, fechas y las **partes procesales ya separadas por rol** (la fuente las entrega en un solo texto plano). Consultando por radicado agrega además el **detalle** (ponente, tipo y clase de proceso, ubicación del expediente) y las **últimas actuaciones con su anotación**, que es lo que responde "en qué va el proceso" y no solo "existe". `status` es siempre `info` cuando hay procesos, nunca `danger`: la lista incluye tutelas, casos cerrados y procesos donde la persona es la DEMANDANTE. Cuesta 1 crédito. Por nombre, cero procesos es un resultado válido y cobra; un radicado que no existe responde 404 y **no cobra**.

Cuerpo de la solicitud

body (JSON)
{
  "radicado": "11001310300320210012300"
}
Parámetros del cuerpo de la solicitud
CampoTipoQué es
radicadostringNúmero de radicado, exactamente 23 dígitos (CCCJJJSSAAAA00000000D: ciudad, juzgado, especialidad, año, consecutivo y dígito de verificación). Los guiones y espacios se ignoran. Se requiere `radicado` o `nombre`. Alias aceptado: `numero`.
nombrestringNombre o razón social de una de las partes. Mínimo 3 caracteres. Si la búsqueda arroja más de mil procesos la fuente la rechaza con 400 `consulta_invalida`: hay que acotarla. Alias aceptado: `razonSocial`.
tipoPersonastringSolo aplica con `nombre`: `nat` (natural) o `jur` (jurídica). Por defecto `nat`. La fuente NO busca en las dos a la vez — pedir una empresa como `nat` devuelve vacío en silencio, que se lee como "no tiene procesos".Valores: nat · jur
soloActivosboolean`true` deja solo los procesos activos. Por defecto vienen todos, incluidos los terminados: un proceso cerrado hace dos años sigue siendo información para quien verifica.
paginanumberPágina de resultados, empezando en 1. La fuente devuelve 20 procesos por página; `paginacion.cantidadPaginas` dice cuántas hay.
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/rama-judicial' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"radicado":"11001310300320210012300"}'
JavaScript (fetch)
const res = await fetch("https://placapi.com/api/rama-judicial", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"radicado":"11001310300320210012300"}),
});
const data = await res.json();
Python (requests)
import requests

res = requests.post(
    "https://placapi.com/api/rama-judicial",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"radicado":"11001310300320210012300"},
)
data = res.json()

Respuesta exitosa

200 OK — datos ficticios de ejemplo
{
  "source": "procesos-judiciales",
  "status": "info",
  "data": {
    "consulta": {
      "radicado": "11001310300320210012300",
      "nombre": "",
      "tipoPersona": ""
    },
    "resumen": {
      "tieneProcesos": true,
      "totalProcesos": 1
    },
    "procesos": [
      {
        "idProceso": 89834312,
        "radicado": "11001310300320210012300",
        "fechaRadicacion": "2021-03-25",
        "fechaUltimaActuacion": "2021-04-12",
        "despacho": "JUZGADO 003 CIVIL DEL CIRCUITO DE BOGOTÁ",
        "departamento": "BOGOTÁ",
        "esPrivado": false,
        "partes": [
          {
            "rol": "Demandante",
            "nombre": "JUAN PEREZ GOMEZ"
          },
          {
            "rol": "Demandado",
            "nombre": "ENTIDAD PUBLICA DE EJEMPLO"
          }
        ],
        "detalle": {
          "ponente": "NOMBRE DEL PONENTE",
          "tipoProceso": "Acción de Tutela",
          "claseProceso": "Tutelas",
          "subclaseProceso": "Sin Subclase de Proceso",
          "recurso": "Sin Tipo de Recurso",
          "ubicacion": "Secretaria - Oficios",
          "ultimaActualizacion": "2026-08-19T18:33:50.517"
        },
        "actuaciones": [
          {
            "fecha": "2021-04-12",
            "actuacion": "Sentencia tutela primera Instancia",
            "anotacion": "CONCEDE",
            "fechaInicial": "",
            "fechaFinal": "",
            "fechaRegistro": "2021-04-12",
            "tieneDocumentos": false
          }
        ],
        "totalActuaciones": 7
      }
    ],
    "paginacion": {
      "pagina": 1,
      "registrosPagina": 20,
      "cantidadPaginas": 1,
      "cantidadRegistros": 1
    }
  },
  "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: 23 de agosto de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.

Contacto