CCB: laudos arbitrales

Los laudos que el centro de arbitraje más grande de Colombia, el de la Cámara de Comercio de Bogotá, publica en su biblioteca digital: partes, árbitros, secretario, radicado, fecha, tipo de contrato, temas, texto y una copia idéntica byte a byte del PDF. Busca por palabras, árbitro, tipo de contrato, radicado, colección o fecha, y lee el texto de un laudo por su handle.

La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye as_of: qué tan actualizados están los datos. Cómo funcionan los datasets.

Buscar laudos

POST /co/ccb-arbitration/awards-search/v1 Dataset Una sola búsqueda sobre todos los laudos, por palabras, árbitro, tipo de contrato, radicado, colección o fecha.

Campo	Tipo	Notas
`query`	string	Palabras opcionales que se buscan en el título, las partes, los árbitros, el tipo de contrato, los temas y el texto, p. ej. `equilibrio económico`, `INVIAS` o `cláusula penal`.
`collection`	enum	Colección opcional: `national` (arbitraje nacional) o `social` (arbitraje social, los tribunales de bajo costo del Centro para controversias de menor cuantía).
`arbitrator`	string	Apellido opcional de un árbitro, con o sin tildes, p. ej. `Cárdenas` o `Cárdenas Mejía`.
`contract_type`	string	Tipo opcional del contrato en disputa, como lo clasifica el Centro, p. ej. `Obra pública`, `Concesión` o `Prestación de servicios`.
`case_number`	string	Radicado opcional que el Centro le dio al arbitraje, p. ej. `145749`.
`from_date`	string	Opcional: solo laudos en esta fecha o después, `yyyy-mm-dd`.
`to_date`	string	Opcional: solo laudos en esta fecha o antes, `yyyy-mm-dd`.
`page`	integer	Número de página, empieza en 1. Por defecto `1`.
`per_page`	integer	Resultados por página (1-50). Por defecto `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" }'

Devuelve as_of (qué tan actualizados están los datos), los filtros aplicados, total y total_is_exact, los campos de paginación (page, per_page, total_pages, count) y results[], los más relevantes primero (sin query, los más recientes primero), un laudo cada uno:

Campo	Notas
`id`, `handle_url`	El handle del laudo, p. ej. `29654` (pásalo a `award` para leer el texto), y su enlace permanente.
`collection`	`national` (arbitraje nacional) o `social` (arbitraje social); `other` para un registro que no está en ninguna de las dos.
`title`, `case_number`	El título como se radicó y el radicado del Centro.
`claimants`, `respondents`	Las partes, convocantes y convocadas, como las escribe el Centro.
`arbitrators`, `secretaries`	Los árbitros y el secretario del tribunal, como `Apellidos, Nombres`.
`award_date`, `year`	La fecha del laudo, `yyyy-mm-dd`, y su año; null en los pocos laudos que el Centro registró sin fecha.
`contract_types`, `subjects`, `sector`	El tipo de contrato en disputa, los temas con los que el Centro indexó el laudo y el sector económico cuando está registrado.
`city`, `language`	Dónde sesionó el tribunal y el idioma del texto, cuando están registrados.
`document_url`, `source_document_url`	La copia de Croma del laudo, idéntica byte a byte a la que publicó la Cámara de Comercio de Bogotá, y el enlace de la fuente.
`documents[]`	Cada archivo publicado con el laudo, el laudo primero, con `name`, `content_type`, `bytes`, `md5`, `document_url` y `source_document_url`.
`text_status`, `text_length`	`ok`, `truncated` o `missing` (un laudo escaneado), y la longitud del texto completo del laudo en caracteres.
`source_updated_at`	Cuándo cambió la fuente por última vez el registro del laudo.

Los resultados de búsqueda no incluyen el texto; query sí busca dentro de él. Lee el texto con award.

Un laudo, con su texto

POST /co/ccb-arbitration/award/v1 Dataset Un laudo por su handle, con su texto.

Campo	Tipo	Notas
`handle`	string	Obligatorio. El handle del laudo, el `id` de un resultado de búsqueda (p. ej. `29654`), o su `handle_url`.
`offset`	integer	Primer carácter del texto a devolver. Envía el `next_offset` de la respuesta anterior para seguir leyendo. Por defecto `0`.
`limit`	integer	Cuántos caracteres del texto devolver. Por defecto `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" }'

Devuelve as_of, found, handle y award: cada campo de un resultado de búsqueda más content, un tramo del texto del laudo:

Campo	Notas
`content.text`, `content.offset`	Un tramo del texto del laudo y el carácter en que empieza.
`content.total_length`	La longitud del texto que guarda Croma; menor que `text_length` cuando el laudo está truncado.
`content.has_more`, `content.next_offset`	Si el texto continúa, y el `offset` que debes enviar para seguir leyendo.

Croma guarda hasta 200.000 caracteres del texto de un laudo; uno más largo dice text_status: truncated, y document_url entrega el laudo completo. content es null cuando text_status es missing (un laudo escaneado).

Un handle bajo el cual la biblioteca no tiene ningún laudo devuelve found: false con HTTP 200, no un error.

Referencia completa

Esquemas, todos los campos de respuesta y un playground interactivo.

Primeros pasos

Tipos de solicitud

Monitores

Comentarios

Países

CCB: laudos arbitrales

Buscar laudos

Un laudo, con su texto

Referencia completa

​Buscar laudos

​Un laudo, con su texto

Referencia completa

Buscar laudos

Un laudo, con su texto