CCB: arbitral awards

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.

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.

Search the awards

POST /co/ccb-arbitration/awards-search/v1 Dataset 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`.

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.

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

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.

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

A handle the library holds no award under returns found: false with HTTP 200, not an error.

Full reference

Schemas, all response fields, and an interactive playground.

Get started

Request types

Monitors

Feedback

Countries

CCB: arbitral awards

Search the awards

One award, with its text

Full reference

​Search the awards

​One award, with its text

Full reference

Search the awards

One award, with its text