> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CCB: sentenças arbitrais

> As sentenças arbitrais do Centro de Arbitragem e Conciliação da CCB, cerca de 2.150 desde 1985, com o texto e uma cópia de cada uma.

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.

> [!NOTE]
>
> 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](https://docs.usecroma.com/pt/datasets.md).

## Buscar sentenças

`POST /co/ccb-arbitration/awards-search/v1` [Dataset](https://docs.usecroma.com/pt/datasets.md)

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`. |

```bash theme={"dark"}
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. |

> [!NOTE]
>
> 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](https://docs.usecroma.com/pt/datasets.md)

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`. |

```bash theme={"dark"}
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. |

> [!NOTE]
>
> 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).

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

> [card] [Referência completa](https://docs.usecroma.com/pt/api-reference/overview.md)
>
> Esquemas, todos os campos de resposta e um playground interativo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.