> ## 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: arbitral awards

> The arbitral awards of the CCB's Arbitration and Conciliation Center, about 2,150 since 1985, with their text and a copy of each one.

The awards that Colombia's largest arbitration center, at the Cámara de Comercio de Bogotá, publishes in its digital library: parties, arbitrators, secretary, case number, date, contract type, subjects, text and a byte-identical copy of the PDF.

Search by words, arbitrator, contract type, case number, collection or date, then read an award's text by its handle.

> [!NOTE]
>
> The whole source, organized and ready to query: every endpoint on this page answers in milliseconds. Every response carries `as_of`: how current the data is. [How datasets work](https://docs.usecroma.com/datasets.md).

## Search the awards

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

One search over every award, by words, arbitrator, contract type, case number, collection or date.

| Field | Type | Notes |
| - | - | - |
| `query` | string | Optional words matched against the title, the parties, the arbitrators, the contract type, the subjects and the text, e.g. `equilibrio económico`, `INVIAS` or `cláusula penal`. |
| `collection` | enum | Optional collection: `national` (national arbitration) or `social` (social arbitration, the Center's low-cost tribunals for small claims). |
| `arbitrator` | string | Optional arbitrator surname, with or without accents, e.g. `Cárdenas` or `Cárdenas Mejía`. |
| `contract_type` | string | Optional type of the contract in dispute, as the Center classifies it, e.g. `Obra pública`, `Concesión` or `Prestación de servicios`. |
| `case_number` | string | Optional case number (radicado) the Center gave the arbitration, e.g. `145749`. |
| `from_date` | string | Optional: only awards on or after this date, `yyyy-mm-dd`. |
| `to_date` | string | Optional: only awards on or before this date, `yyyy-mm-dd`. |
| `page` | integer | 1-based page number. Default `1`. |
| `per_page` | integer | Results per page (1-50). Default `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" }'
```

Returns `as_of` (how current the data is), the filters applied, `total` and `total_is_exact`, the paging fields (`page`, `per_page`, `total_pages`, `count`) and `results[]`, best match first (newest first without a `query`), one award each:

| Field | Notes |
| - | - |
| `id`, `handle_url` | The award's handle, e.g. `29654` (pass it to `award` for the text), and its permanent link. |
| `collection` | `national` (national arbitration) or `social` (social arbitration); `other` for a record filed in neither. |
| `title`, `case_number` | The title as filed and the Center's case number (radicado). |
| `claimants`, `respondents` | The parties, as the Center writes them. |
| `arbitrators`, `secretaries` | The tribunal's arbitrators and secretary, as `Surnames, Given names`. |
| `award_date`, `year` | The date of the award, `yyyy-mm-dd`, and its year; null on the few awards the Center filed without one. |
| `contract_types`, `subjects`, `sector` | The type of contract in dispute, the topics the Center indexed the award under, and the economic sector where recorded. |
| `city`, `language` | Where the tribunal sat and the language of the text, where recorded. |
| `document_url`, `source_document_url` | Croma's copy of the award, byte for byte as the Cámara de Comercio de Bogotá published it, and the source's own link. |
| `documents[]` | Every file published with the award, the award itself first, each with `name`, `content_type`, `bytes`, `md5`, `document_url` and `source_document_url`. |
| `text_status`, `text_length` | `ok`, `truncated` or `missing` (a scanned award), and the length of the award's whole text in characters. |
| `source_updated_at` | When the source last changed the award's record. |

> [!NOTE]
>
> Search results leave out the text; `query` still matches it. Read the text with `award`.

## One award, with its text

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

An award by its handle, with its text.

| Field | Type | Notes |
| - | - | - |
| `handle` | string | **Required.** The award's handle, the `id` of a search result (e.g. `29654`), or its `handle_url`. |
| `offset` | integer | First character of the text to return. Pass the previous response's `next_offset` to read on. Default `0`. |
| `limit` | integer | How many characters of the text to return. Default `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" }'
```

Returns `as_of`, `found`, `handle` and `award`: every field of a search result plus `content`, a range of the award's text:

| Field | Notes |
| - | - |
| `content.text`, `content.offset` | A range of the award's text, and the character it starts at. |
| `content.total_length` | The length of the text Croma keeps; shorter than `text_length` when the award is truncated. |
| `content.has_more`, `content.next_offset` | Whether the text continues, and the `offset` to send to read on. |

> [!NOTE]
>
> Croma keeps up to 200,000 characters of an award's text; a longer one says `text_status: truncated`, and `document_url` gives the whole award. `content` is null when `text_status` is `missing` (a scanned award).

> [!NOTE]
>
> A handle the library holds no award under returns `found: false` with HTTP 200, not an error.

> [card] [Full reference](https://docs.usecroma.com/api-reference/overview.md)
>
> Schemas, all response fields, and an interactive playground.


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