Rama Judicial

Rama Judicial é o registro nacional do poder judiciário da Colômbia. A Croma expõe quatro endpoints sobre ele: buscar processos por parte, 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, e o diretório de e-mails, em dobro: a caixa oficial de cada despacho judicial e área administrativa, navegável por lugar e especialidade, ou resolvido diretamente de um código de despacho ou um radicado.

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

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.

Encontrar o e-mail de um despacho

POST /co/rama-judicial/email-directory/v1 Dataset Busca no diretório oficial de e-mails do poder judiciário: todos os despachos judiciais e áreas administrativas, filtráveis por lugar, tipo de despacho, especialidade, seccional ou o código de despacho com que começa todo radicado.

Campo	Tipo	Notas
`query`	string	Palavras opcionais buscadas no nome do despacho, no endereço de e-mail, e em sua corporação, especialidade, departamento, cidade e seccional.
`department`	string	Departamento opcional, buscado a partir do início do nome: `santander`, `bogota`. Maiúsculas e acentos são ignorados.
`city`	string	Cidade opcional, buscada a partir do início do nome: `bogota` encontra Bogotá D.C.
`corporation`	string	Tipo de despacho opcional, buscado a partir do início do nome: `juzgado` encontra todos os juzgados, `tribunal-superior`, `centro-de-servicios`, `corte-suprema`.
`specialty`	string	Especialidade opcional, buscada a partir do início do nome: `civil`, `laboral`, `familia`, `penal` (que também encontra as subespecialidades penais).
`account_type`	enum	Tipo de conta opcional: `despacho` para a caixa própria de um despacho, `area` para uma área administrativa ou de serviços. Vazio retorna ambos.
`court_code`	string	Código de despacho opcional de 12 dígitos. Um radicado completo de 20-25 dígitos também é aceito: seus primeiros 12 dígitos identificam o despacho onde o caso está registrado, então isto resolve “qual despacho tem este caso e qual é o seu e-mail” em uma única chamada.
`district`	string	Seccional opcional, buscada a partir do início do nome: `bucaramanga`, `nivel-central`.
`page`	integer	Número da página, começa em 1. Por padrão `1`.
`per_page`	integer	Resultados por página (1-100). Por padrão `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" }'

Retorna as_of (o quão atuais são os dados), os filtros aplicados, total, page, per_page, total_pages, count e results[], ordenados pelo nome do despacho. Cada resultado traz email, name, account_type (“Despacho Judicial” ou “Área”), corporation, specialty, department, city, district (a seccional), court_code, e as variantes canônicas *_key com as quais os filtros comparam por prefixo.

O diretório é servido da cópia própria da Croma, atualizada semanalmente do diretório oficial da Rama Judicial, então as buscas respondem rápido e não dependem da fonte estar disponível. as_of indica quando a cópia foi atualizada pela última vez.

Resolver o e-mail de um despacho a partir de um caso

POST /co/rama-judicial/emails-by-court/v1 Dataset Resolve a caixa oficial de um despacho a partir do seu código de 12 dígitos, ou diretamente de um radicado completo. Sem paginação: todas as contas que o diretório tem para esse código chegam de uma vez, primeiro a caixa própria do despacho.

Campo	Tipo	Notas
`court_code`	string	Obrigatório. O código de despacho de 12 dígitos, ou um radicado completo de 20-25 dígitos: seus primeiros 12 dígitos identificam o despacho onde o caso está registrado. O `court_code` de qualquer resultado do diretório e os primeiros 12 dígitos de qualquer `registration_number` são 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" }'

Retorna as_of, found, o court_code (recortado), count e mailboxes[], cada um com os mesmos campos de um resultado do diretório.

Um código que o diretório não contém retorna found: false com HTTP 200, não um erro. Alguns despachos não publicam caixa própria e são atendidos por um centro de serviços; buscar no diretório por lugar e especialidade é a alternativa.

Os endpoints de processos consultam uma fonte ao vivo que pode responder com lentidão ou ficar brevemente indisponível, e podem retornar 502 upstream_error; tente novamente com backoff. O diretório de e-mails é servido da cópia própria da Croma e não depende dela.

Referência completa

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

Primeiros passos

Tipos de solicitação

Países

Buscar processos

Resolver por radicación

Resolver vários radicados (lote)

Encontrar o e-mail de um despacho

Resolver o e-mail de um despacho a partir de um caso

Referência completa

​Buscar processos

​Resolver por radicación

​Resolver vários radicados (lote)

​Encontrar o e-mail de um despacho

​Resolver o e-mail de um despacho a partir de um caso

Referência completa

Buscar processos

Resolver por radicación

Resolver vários radicados (lote)

Encontrar o e-mail de um despacho

Resolver o e-mail de um despacho a partir de um caso