Rama Judicial

Rama Judicial es el registro nacional de la rama judicial de Colombia. Croma expone cuatro endpoints sobre él: buscar procesos por parte, 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, y el directorio de correos, por partida doble: el buzón oficial de cada despacho judicial y área administrativa, navegable por lugar y especialidad, o resuelto directamente desde un código de despacho o un radicado.

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" }'

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.

Encontrar el correo de un despacho

POST /co/rama-judicial/email-directory/v1 Dataset Busca en el directorio oficial de correos de la rama judicial: todos los despachos judiciales y áreas administrativas, filtrables por lugar, tipo de despacho, especialidad, seccional o el código de despacho con el que empieza todo radicado.

Campo	Tipo	Notas
`query`	string	Palabras opcionales que se buscan en el nombre del despacho, la dirección de correo, y su corporación, especialidad, departamento, ciudad y seccional.
`department`	string	Departamento opcional, se busca desde el comienzo del nombre: `santander`, `bogota`. No importan mayúsculas ni tildes.
`city`	string	Ciudad opcional, se busca desde el comienzo del nombre: `bogota` encuentra Bogotá D.C.
`corporation`	string	Tipo de despacho opcional, se busca desde el comienzo del nombre: `juzgado` encuentra todos los juzgados, `tribunal-superior`, `centro-de-servicios`, `corte-suprema`.
`specialty`	string	Especialidad opcional, se busca desde el comienzo del nombre: `civil`, `laboral`, `familia`, `penal` (que también encuentra las subespecialidades penales).
`account_type`	enum	Tipo de cuenta opcional: `despacho` para el buzón propio de un despacho, `area` para un área administrativa o de servicios. Vacío devuelve ambos.
`court_code`	string	Código de despacho opcional de 12 dígitos. También se acepta un radicado completo de 20-25 dígitos: sus primeros 12 dígitos identifican el despacho donde está radicado el caso, así que esto resuelve “qué despacho lleva este caso y cuál es su correo” en una sola llamada.
`district`	string	Seccional opcional, se busca desde el comienzo del nombre: `bucaramanga`, `nivel-central`.
`page`	integer	Número de página, empieza en 1. Por defecto `1`.
`per_page`	integer	Resultados por página (1-100). Por defecto `20`.

curl https://api.croma.run/co/rama-judicial/email-directory/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "city": "bucaramanga", "specialty": "penal" }'

Devuelve as_of (qué tan actualizados están los datos), los filtros aplicados, total, page, per_page, total_pages, count y results[], ordenados por nombre del despacho. Cada resultado incluye email, name, account_type (“Despacho Judicial” o “Área”), corporation, specialty, department, city, district (la seccional), court_code, y las variantes canónicas *_key con las que los filtros comparan por prefijo.

El directorio se sirve desde la copia propia de Croma, actualizada cada semana desde el directorio oficial de la Rama Judicial, así que las búsquedas responden rápido y no dependen de que la fuente esté disponible. as_of indica cuándo se actualizó la copia por última vez.

Resolver el correo de un despacho desde un caso

POST /co/rama-judicial/emails-by-court/v1 Dataset Resuelve el buzón oficial de un despacho desde su código de 12 dígitos, o directamente desde un radicado completo. Sin paginación: todas las cuentas que el directorio tiene para ese código llegan de una vez, primero el buzón propio del despacho.

Campo	Tipo	Notas
`court_code`	string	Obligatorio. El código de despacho de 12 dígitos, o un radicado completo de 20-25 dígitos: sus primeros 12 dígitos identifican el despacho donde está radicado el caso. El `court_code` de cualquier resultado del directorio y los primeros 12 dígitos de cualquier `registration_number` son valores válidos.

curl https://api.croma.run/co/rama-judicial/emails-by-court/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "court_code": "110013103021" }'

Devuelve as_of, found, el court_code (recortado), count y mailboxes[], cada uno con los mismos campos que un resultado del directorio.

Un código que el directorio no contiene devuelve found: false con HTTP 200, no un error. Algunos despachos no publican buzón propio y los atiende un centro de servicios; buscar en el directorio por lugar y especialidad es la alternativa.

Los endpoints de procesos consultan una fuente en vivo que puede responder con lentitud o estar brevemente no disponible, y pueden devolver 502 upstream_error; reintenta con backoff. El directorio de correos se sirve desde la copia propia de Croma y no depende de ella.

Referencia completa

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

Primeros pasos

Tipos de solicitud

Países

Buscar procesos

Resolver por radicación

Resolver muchos radicados (lote)

Encontrar el correo de un despacho

Resolver el correo de un despacho desde un caso

Referencia completa

​Buscar procesos

​Resolver por radicación

​Resolver muchos radicados (lote)

​Encontrar el correo de un despacho

​Resolver el correo de un despacho desde un caso

Referencia completa

Buscar procesos

Resolver por radicación

Resolver muchos radicados (lote)

Encontrar el correo de un despacho

Resolver el correo de un despacho desde un caso