--- title: "SIC Acts Search" method: POST path: "/co/sic-actos/acts-search/v1" tags: ["Colombia", "SIC Acts"] --- # SIC Acts Search `POST /co/sic-actos/acts-search/v1` ## Request - Base URL: `https://api.croma.run` - URL: `https://api.croma.run/co/sic-actos/acts-search/v1` - Auth: HTTP bearer Search every administrative act and judgment in the register of Colombia's Superintendencia de Industria y Comercio (SIC) since 2014: about 144,000 resoluciones of its investigations and 136,000 sentencias of its jurisdictional delegation. Free text matches the full text, the parties' names, the decisions and the office. Filter by `party_document_number` (a NIT or cédula of any party or representative), `case_number` (the radicado), `office`, `type` (`resolution`, `judgment`) and the date of the act (`issued_from`/`issued_to`). Each result carries the parties with their identification and Croma's copy of the act's document. Served by Croma (`as_of` says how current the data is). **Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`. ## Headers - `Idempotency-Key` string ## Request body - object - `query` string: Optional search terms matched against the full text, the parties' names, the decisions and the office. - `type` 'any' | 'resolution' | 'judgment': Type of act: `resolution` (resolución) or `judgment` (sentencia), or `any`. - `office` string: Optional issuing office, e.g. `Grupo de Trabajo de Defensa del Consumidor`, matched from the start. Case and accents are ignored. - `case_number` string: Optional case (radicado), e.g. `24-449511` or `24 449511`. - `party_document_number` string: Optional identification number (NIT or cédula) of any party or representative, digits only; separators are ignored. - `issued_from` string, date: Optional date filter in yyyy-mm-dd format. - `issued_to` string, date: Optional date filter in yyyy-mm-dd format. - `page` integer: 1-based page number for paginated results. - `per_page` integer: Results per page (1-50). ## Response `200` Successful response - SicActsSearchResponse - `data` SicActsSearchData, required - `as_of` string, nullable, required: How current the data in this response is. - `query` string, required - `type` string, nullable, required - `office` string, nullable, required - `case_number` string, nullable, required - `party_document_number` string, nullable, required - `issued_from` string, nullable, required - `issued_to` string, nullable, required - `total` number, required: Matches, counted up to 1000. - `total_is_exact` boolean, required: False when more than 1000 match: `total` is then 1000, and the pages go on. - `page` number, required - `per_page` number, required - `total_pages` number, required: Pages over `total`; there are more when `total_is_exact` is false. - `count` number, required - `results` object[], required - `id` string, required: The act's permanent number in the Superintendencia's register of administrative acts. - `act_id` string, nullable, required: The Superintendencia's own id of the act. - `type` 'resolution' | 'judgment' | 'other', required: `resolution` (resolución) or `judgment` (sentencia); `other` for anything else. - `type_label` string, nullable, required: The kind of act as the register prints it, e.g. "RE-RESOLUCION", "SE-SENTENCIA". - `number` string, nullable, required: The act's number. - `issued_at` string, nullable, required: `yyyy-mm-dd` the act was issued. - `office` string, nullable, required: The office (dependencia) that issued it. - `case_number` string, nullable, required: The case (radicado) the act belongs to, e.g. "24-449511". - `decisions` object[], required: What the act decides, as the Superintendencia classifies it. - `class` string, nullable, required: The class of the decision, e.g. "SENTENCIA ACEPTA ALLANAMIENTO CON ORDEN", "INVESTIGACION". - `name` string, nullable, required: What the act decides, e.g. "ORDENA DEVOLUCION DINERO", "IMPONE SANCION". - `act_type` string, nullable, required: The kind of act the decision belongs to, e.g. "SP-SENTENCIA PROTECCION". - `parties` object[], required: The parties the Superintendencia records for the act. - `name` string, nullable, required: The party's name as the Superintendencia records it. - `role` string, nullable, required: The party's role, e.g. "INVESTIGADO", "QUEJOSO", "APODERADO", "REPRESENTANTE LEGAL". - `document_type` string, nullable, required: The kind of identification, e.g. "CC - CEDULA DE CIUDADANIA", "NI - NIT". - `document_number` string, nullable, required: The identification number, digits only. - `representative_name` string, nullable, required: The name of the party's representative, when the Superintendencia records one. - `representative_document_type` string, nullable, required: The representative's kind of identification. - `representative_document_number` string, nullable, required: The representative's identification number, digits only. - `party_document_numbers` string[], required: Every party's and representative's identification number, digits only, which is what the `party_document_number` filter matches. - `file_name` string, nullable, required: The name the Superintendencia gave the act's document. - `registered_at` string, nullable, required: When the act entered the register. - `modified_at` string, nullable, required: When the register last changed the act. - `text_status` 'ok' | 'scanned' | 'missing', required: `ok` when the full text is here; `scanned` when the document is an image with no text in it; `missing` when no document could be read. - `document_url` string, nullable, required: Croma's copy of the act's document (PDF), byte for byte as the Superintendencia published it. Null when it could not be kept. - `source_document_url` string, nullable, required: Always null: the Superintendencia publishes the document only through its search tool, with no permanent link. - `document_bytes` number, nullable, required: Size of the document in bytes. ## Other responses - `400`: Invalid request body - `401`: Missing or invalid API key - `429`: Rate limit exceeded - `500`: Internal error - `502`: Upstream source returned an error --- [API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)