Endpoint: procesos judiciales por juzgado o ponente

Consulta los procesos de la Rama Judicial por ponente o juez y clase de proceso, con un código de despacho opcional. Devuelve los procesos, el despacho, el departamento y las partes separadas por rol. Cero procesos es una respuesta válida: ese juzgado y esa clase no tienen publicaciones, y la consulta cobra. No es un certificado de antecedentes ni un veredicto sobre la persona.

POST/api/rama-juzgado1 crédito

Procesos judiciales de la Rama por ponente/juez + clase de proceso, con código de despacho opcional. Es una extensión de /api/rama-judicial (que sigue consultando por radicado o nombre): usa JuezClaseProceso. Devuelve los procesos, su despacho/departamento y las partes separadas por rol; cero procesos es una respuesta válida (ese juzgado/clase no tiene publicaciones) y COBRA. Cuesta 1 crédito.

Cuerpo de la solicitud

body (JSON)

{
  "ponente": "PONENTE DE PRUEBA",
  "claseProceso": "CLASE DE PRUEBA"
}

Parámetros del cuerpo de la solicitud
Campo	Tipo	Qué es
ponenteobligatorio	string	Nombre del ponente/juez, mínimo 3 caracteres. Alias: `juez`, `juzgado`.
claseProcesoobligatorio	string	Clase de proceso, mínimo 3 caracteres. Alias: `clase`.
codificacionDespacho	string	Código de despacho o parte del código (solo dígitos, hasta 20). Alias: `despacho`, `codigoDespacho`.
pagina	number	Página de resultados, empezando en 1. La fuente devuelve 20 por página.
refresh	boolean	Ignora 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-juzgado' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"ponente":"PONENTE DE PRUEBA","claseProceso":"CLASE DE PRUEBA"}'

JavaScript (fetch)

const res = await fetch("https://placapi.com/api/rama-juzgado", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"ponente":"PONENTE DE PRUEBA","claseProceso":"CLASE DE PRUEBA"}),
});
const data = await res.json();

Python (requests)

import requests

res = requests.post(
    "https://placapi.com/api/rama-juzgado",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"ponente":"PONENTE DE PRUEBA","claseProceso":"CLASE DE PRUEBA"},
)
data = res.json()

Respuesta exitosa

200 OK — ejemplo (placas y documentos ficticios)

{
  "source": "procesos-judiciales",
  "status": "ok",
  "data": {
    "consulta": {
      "ponente": "PONENTE DE PRUEBA",
      "claseProceso": "CLASE DE PRUEBA",
      "codificacionDespacho": ""
    },
    "resumen": {
      "tieneProcesos": false,
      "totalProcesos": 0
    },
    "procesos": [],
    "paginacion": {
      "pagina": 1,
      "registrosPagina": 20,
      "cantidadPaginas": 0,
      "cantidadRegistros": 0
    }
  },
  "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: 30 de octubre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.