Rama Judicial

Rama Judicial é o registro nacional do poder judiciário da Colômbia. A Croma expõe dois endpoints sobre ele: buscar processos por parte e resolver um caso pelo seu número de registro (radicación), que retorna os metadados do caso junto com o histórico de actuaciones em uma única chamada.

Buscar processos

POST /co/rama-judicial/cases-by-entity/v1 encontra processos por nome de entidade.

Campo	Tipo	Notas
`name`	string	Obrigatório. 3-200 caracteres. Nome da entidade a buscar.
`entity_type`	enum	Tipo de entidade: `natural` ou `juridical`. Por padrão `natural`.
`active_only`	boolean	Restringe a processos com atividade nos últimos 30 dias. Por padrão `false`.
`court_code`	string	Restringe a um juzgado específico.
`page`	integer	1-1000. Por padrão `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 resolve um caso pelo seu número de radicación de 23 dígitos e retorna os metadados junto com as primeiras 40 actuaciones disponíveis. Quando nenhum caso público coincide, found é false e primary_case é null.

Campo	Tipo	Notas
`registration_number`	string	Obrigatório. 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 vários radicados (lote)

POST /co/rama-judicial/cases-by-radicado/v1/batch resolve até 50 radicados em uma única solicitação. Os itens são resolvidos de forma concorrente e devolvidos na mesma ordem, cada um com seu próprio status, de modo que um radicado defeituoso nunca faz o lote falhar.

Campo	Tipo	Notas
`items`	array	Obrigatório. De 1 a 50 objetos, cada um `{ "registration_number": "…" }` (o mesmo corpo do 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 item conta como uma solicitação contra a sua cota. Consulte Solicitações em lote para o envelope de resposta e o tratamento de falhas parciais.

Rama Judicial é uma fonte ao vivo e pode responder com lentidão ou ficar brevemente indisponível. Estes endpoints podem retornar 502 upstream_error; tente novamente com backoff.

Referência completa

Esquemas, todos os campos de resposta e um playground interativo.

Primeiros passos

Países

Buscar processos

Resolver por radicación

Resolver vários radicados (lote)

Referência completa

​Buscar processos

​Resolver por radicación

​Resolver vários radicados (lote)

Referência completa

Buscar processos

Resolver por radicación

Resolver vários radicados (lote)