> ## 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: laudos arbitrales > Los laudos arbitrales del Centro de Arbitraje y Conciliación de la CCB, cerca de 2.150 desde 1985, con su texto y una copia de cada uno. 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. > [!NOTE] > > 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](https://docs.usecroma.com/es/datasets.md). ## Buscar laudos `POST /co/ccb-arbitration/awards-search/v1` [Dataset](https://docs.usecroma.com/es/datasets.md) 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`. | ```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" }' ``` 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. | > [!NOTE] > > 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](https://docs.usecroma.com/es/datasets.md) 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`. | ```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" }' ``` 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. | > [!NOTE] > > 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). > [!NOTE] > > Un handle bajo el cual la biblioteca no tiene ningún laudo devuelve `found: false` con HTTP 200, no un error. > [card] [Referencia completa](https://docs.usecroma.com/es/api-reference/overview.md) > > Esquemas, todos los campos de respuesta y un playground interactivo. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.