---
title: "SIC Act"
method: POST
path: "/co/sic-actos/act/v1"
tags: ["Colombia", "SIC Acts"]
---

# SIC Act

`POST /co/sic-actos/act/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/co/sic-actos/act/v1`
- Auth: HTTP bearer

Retrieve one administrative act or judgment from the register of Colombia's Superintendencia de Industria y Comercio (SIC) by its `id` from a search result: its full text, number, date, office, case, decisions, parties with their identification and Croma's copy of its document. The text comes back a character range at a time (`offset`, `limit`); follow `next_offset` until `has_more` is false.

**Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `act_id` string, required: The act's `id` from a search result, e.g. `2681688`.
  - `offset` integer: First character of the range to return. Pass the previous response's `next_offset` to continue reading.
  - `limit` integer: Maximum characters to return (1000-1000000).

## Response `200`

Successful response

- SicActResponse
  - `data` SicActData, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `found` boolean, required
    - `act_id` string, required
    - `act` object, nullable, 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.
      - `content` object, nullable, required: A range of the act's text, or null when `text_status` is not `ok`.
        - `text` string, required: The requested character range of the act's text.
        - `offset` number, required: First character of the range, which is where the reading actually started.
        - `total_length` number, required: Length of the whole text in characters, however much of it this response carries.
        - `has_more` boolean, required: Whether the text continues past this range.
        - `next_offset` number, nullable, required: Pass this back as `offset` to read the next range. Null at the end of the text.

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