Rama Judicial

Rama Judicial es el registro nacional de la rama judicial de Colombia. Croma expone dos endpoints sobre él: buscar procesos por parte y resolver un caso por su número de radicación (radicación), que devuelve los metadatos del caso junto con el historial de actuaciones en una sola llamada.

Buscar procesos

POST /co/rama-judicial/cases-by-entity/v1 encuentra procesos por nombre de entidad.

Campo	Tipo	Notas
`name`	string	Obligatorio. 3-200 caracteres. Nombre de la entidad a buscar.
`entity_type`	enum	Tipo de entidad: `natural` o `juridical`. Por defecto `natural`.
`active_only`	boolean	Restringe a procesos con actividad en los últimos 30 días. Por defecto `false`.
`court_code`	string	Acota a un juzgado específico.
`page`	integer	1-1000. Por defecto `1`.

curl https://api.croma.run/co/rama-judicial/cases-by-entity/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "PEDRO CIFUENTES", "entity_type": "natural", "page": 1 }'

Resolver por radicación

POST /co/rama-judicial/cases-by-radicado/v1 resuelve un caso por su número de radicación de 23 dígitos y devuelve los metadatos junto con las primeras 40 actuaciones disponibles. Cuando ningún caso público coincide, found es false y primary_case es null.

Campo	Tipo	Notas
`registration_number`	string	Obligatorio. 20-25 dígitos (radicación).

curl https://api.croma.run/co/rama-judicial/cases-by-radicado/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "registration_number": "11001600001720180327700" }'

Resolver muchos radicados (lote)

POST /co/rama-judicial/cases-by-radicado/v1/batch resuelve hasta 50 radicados en una sola solicitud. Los elementos se resuelven de forma concurrente y se devuelven en el mismo orden, cada uno con su propio estado, así que un radicado defectuoso nunca hace fallar el lote.

Campo	Tipo	Notas
`items`	array	Obligatorio. De 1 a 50 objetos, cada uno `{ "registration_number": "…" }` (el mismo cuerpo que el endpoint individual).

curl https://api.croma.run/co/rama-judicial/cases-by-radicado/v1/batch \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "items": [
        { "registration_number": "11001600001720180327700" },
        { "registration_number": "05001310300120190012300" }
      ] }'

Cada elemento cuenta como una solicitud contra tu cuota. Consulta Solicitudes en lote para el sobre de respuesta y el manejo de fallas parciales.

Rama Judicial es una fuente en vivo y puede responder con lentitud o estar brevemente no disponible. Estos endpoints pueden devolver 502 upstream_error; reintenta con backoff.

Referencia completa

Esquemas, todos los campos de respuesta y un playground interactivo.

Primeros pasos

Colombia

Perú

Global

Buscar procesos

Resolver por radicación

Resolver muchos radicados (lote)

Referencia completa

​Buscar procesos

​Resolver por radicación

​Resolver muchos radicados (lote)

Referencia completa

Buscar procesos

Resolver por radicación

Resolver muchos radicados (lote)