CCB: sentenças arbitrais

As sentenças que o maior centro de arbitragem da Colômbia, o da Cámara de Comercio de Bogotá, publica em sua biblioteca digital: partes, árbitros, secretário, número do processo, data, tipo de contrato, temas, texto e uma cópia idêntica byte a byte do PDF. Busque por palavras, árbitro, tipo de contrato, número do processo, coleção ou data, e leia o texto de uma sentença pelo seu handle.

A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz as_of: o quão atuais são os dados. Como funcionam os datasets.

Buscar sentenças

POST /co/ccb-arbitration/awards-search/v1 Dataset Uma única busca sobre todas as sentenças, por palavras, árbitro, tipo de contrato, número do processo, coleção ou data.

Campo	Tipo	Notas
`query`	string	Palavras opcionais buscadas no título, nas partes, nos árbitros, no tipo de contrato, nos temas e no texto, p. ex. `equilibrio económico`, `INVIAS` ou `cláusula penal`.
`collection`	enum	Coleção opcional: `national` (arbitragem nacional) ou `social` (arbitragem social, os tribunais de baixo custo do Centro para causas de menor valor).
`arbitrator`	string	Sobrenome opcional de um árbitro, com ou sem acentos, p. ex. `Cárdenas` ou `Cárdenas Mejía`.
`contract_type`	string	Tipo opcional do contrato em disputa, como o Centro o classifica, p. ex. `Obra pública`, `Concesión` ou `Prestación de servicios`.
`case_number`	string	Número opcional do processo (radicado) que o Centro deu à arbitragem, p. ex. `145749`.
`from_date`	string	Opcional: só sentenças nesta data ou depois, `yyyy-mm-dd`.
`to_date`	string	Opcional: só sentenças nesta data ou antes, `yyyy-mm-dd`.
`page`	integer	Número da página, começa em 1. Por padrão `1`.
`per_page`	integer	Resultados por página (1-50). Por padrão `10`.

curl https://api.croma.run/co/ccb-arbitration/awards-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "equilibrio económico", "contract_type": "Obra pública" }'

Retorna as_of (o quão atuais são os dados), os filtros aplicados, total e total_is_exact, os campos de paginação (page, per_page, total_pages, count) e results[], as mais relevantes primeiro (sem query, as mais recentes primeiro), uma sentença cada:

Campo	Notas
`id`, `handle_url`	O handle da sentença, p. ex. `29654` (envie-o a `award` para ler o texto), e seu link permanente.
`collection`	`national` (arbitragem nacional) ou `social` (arbitragem social); `other` para um registro que não está em nenhuma das duas.
`title`, `case_number`	O título como foi registrado e o número do processo (radicado) no Centro.
`claimants`, `respondents`	As partes, requerentes e requeridos, como o Centro as escreve.
`arbitrators`, `secretaries`	Os árbitros e o secretário do tribunal, como `Sobrenomes, Nomes`.
`award_date`, `year`	A data da sentença, `yyyy-mm-dd`, e seu ano; null nas poucas sentenças que o Centro registrou sem data.
`contract_types`, `subjects`, `sector`	O tipo de contrato em disputa, os temas com que o Centro indexou a sentença e o setor econômico quando registrado.
`city`, `language`	Onde o tribunal se reuniu e o idioma do texto, quando registrados.
`document_url`, `source_document_url`	A cópia da Croma da sentença, idêntica byte a byte à que a Cámara de Comercio de Bogotá publicou, e o link da fonte.
`documents[]`	Cada arquivo publicado com a sentença, a sentença primeiro, com `name`, `content_type`, `bytes`, `md5`, `document_url` e `source_document_url`.
`text_status`, `text_length`	`ok`, `truncated` ou `missing` (uma sentença digitalizada), e o comprimento do texto completo da sentença em caracteres.
`source_updated_at`	Quando a fonte mudou pela última vez o registro da sentença.

Os resultados da busca não incluem o texto; query busca dentro dele. Leia o texto com award.

Uma sentença, com seu texto

POST /co/ccb-arbitration/award/v1 Dataset Uma sentença pelo seu handle, com seu texto.

Campo	Tipo	Notas
`handle`	string	Obrigatório. O handle da sentença, o `id` de um resultado de busca (p. ex. `29654`), ou sua `handle_url`.
`offset`	integer	Primeiro caractere do texto a retornar. Envie o `next_offset` da resposta anterior para continuar lendo. Por padrão `0`.
`limit`	integer	Quantos caracteres do texto retornar. Por padrão `200000`.

curl https://api.croma.run/co/ccb-arbitration/award/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "handle": "29654" }'

Retorna as_of, found, handle e award: cada campo de um resultado de busca mais content, um trecho do texto da sentença:

Campo	Notas
`content.text`, `content.offset`	Um trecho do texto da sentença e o caractere em que começa.
`content.total_length`	O comprimento do texto que a Croma guarda; menor que `text_length` quando a sentença está truncada.
`content.has_more`, `content.next_offset`	Se o texto continua, e o `offset` a enviar para continuar lendo.

A Croma guarda até 200.000 caracteres do texto de uma sentença; uma mais longa diz text_status: truncated, e document_url entrega a sentença completa. content é null quando text_status é missing (uma sentença digitalizada).

Um handle sob o qual a biblioteca não tem nenhuma sentença retorna found: false com HTTP 200, não um erro.

Referência completa

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

Primeiros passos

Tipos de solicitação

Monitores

Feedback

Países

CCB: sentenças arbitrais

Buscar sentenças

Uma sentença, com seu texto

Referência completa

​Buscar sentenças

​Uma sentença, com seu texto

Referência completa

Buscar sentenças

Uma sentença, com seu texto