---
title: "SIC Filing"
method: POST
path: "/co/sic-tramites/case/v1"
tags: ["Colombia", "SIC Trámites"]
---

# SIC Filing

`POST /co/sic-tramites/case/v1`

## Request

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

Read one filing (radicado) at Colombia's Superintendencia de Industria y Comercio (SIC), the way one of its parties reads it: give the `year` and `case_number` of the radicado (plus `case_control` when it has one) and the `document_type` and `document_number` of one of its parties. Returns every action (consecutivo) with its procedure (trámite), event, action, direction, date and sender or addressee, plus the administrative acts (autos, sentencias, resoluciones) issued in the filing. With `include_documents` (the default) every document of every action and every act is returned with `document_url`, a stored byte-identical copy, and `source_document_url`; this can take a few minutes, so set `include_documents: false` when only the actions are needed. `document_type` defaults to `NIT`. `found: false` when the filing does not exist or the document is not one of its parties': the Superintendencia does not tell the two apart.

Supports async delivery: set `Prefer: wait=N` for an inline result, pass `callback_url` to receive a POST when ready, or poll `GET /jobs/{id}`.

## Headers

- `Idempotency-Key` string
- `Prefer` string

## Request body

- object
  - `year` integer, required: Year of the filing (radicado), four digits, e.g. `2025`.
  - `case_number` string, required: Number of the filing (número de radicado) without the year, e.g. `194793`.
  - `case_control` string: Optional control characters of the filing (control radicado), up to 2. Most filings have none.
  - `document_type` 'CC' | 'CE' | 'NIT' | 'PA' | 'TI' | 'RC' | 'PEP' | 'PPT': Colombian document type. Defaults to `NIT`.
  - `document_number` string, required: Document number (alphanumeric with hyphens allowed).
  - `include_documents` boolean: When true (the default), every document of the filing is returned with a `document_url` to a stored copy. Set to `false` for the actions alone, which answers much faster.
  - `cache` boolean: Set to `false` to skip any stored result for this lookup and read the source again. The fresh answer replaces the stored one and is charged as a new request. Default `true`.
  - `callback_url` string, uri: POST the job result here when it finishes.

## Response `200`

Successful response

- SicTramitesCaseResponse
  - `data` SicTramitesCaseData, required
    - `found` boolean, required: Whether the filing exists and the document belongs to one of its parties.
    - `year` integer, required
    - `case_number` string, required
    - `case_control` string, nullable, required
    - `document_type` string, required
    - `document_number` string, required
    - `procedure` string, nullable, required: The filing's procedure (trámite).
    - `filed_at` string, nullable, required: When the filing was made: the date of its first action.
    - `last_action_at` string, nullable, required: The date of its most recent action.
    - `total_actions` integer, required
    - `actions` object[], required: Every action of the filing, oldest first.
      - `sequence_number` integer, required: Position of the action in the filing (consecutivo), from 0.
      - `procedure` string, nullable, required: The procedure (trámite), e.g. `DEMANDA PROTECCIÓN CONSUMIDOR JURISDICCIONAL`.
      - `event` string, nullable, required: The event (evento), e.g. `DEMANDA`.
      - `action` string, nullable, required: The action (actuación), e.g. `PRESENTACION`, `FIJACION EN LISTA`.
      - `direction` string, nullable, required: The Superintendencia's code for the action's direction: `EN` (incoming), `SA` (outgoing), `TR` (internal).
      - `date` string, nullable, required: When the action was filed, `yyyy-mm-ddThh:mm:ss`, Bogotá time.
      - `party` string, nullable, required: The sender or addressee of the action (solicitante / destinatario).
      - `parent_case` object, nullable, required: The filing this one was joined to, when it was.
        - `year` integer, nullable, required
        - `case_number` string, nullable, required
        - `case_control` string, nullable, required
      - `joined_cases` object[], required: Filings joined to this one (acumulados).
        - `year` integer, nullable, required
        - `case_number` string, nullable, required
        - `case_control` string, nullable, required
      - `has_documents` boolean, required: Whether the Superintendencia publishes documents for this action.
      - `documents` object[], required: The action's documents. Empty when `include_documents` is false or the action has none.
        - `label` string, required: How the Superintendencia labels the file, e.g. `presentacion - página 1`. Each label is a separate file.
        - `file_name` string, required: The file name the Superintendencia published the document under, e.g. `25194793--0000000001.PDF`.
        - `content_type` string, nullable, required: The document's type, read from its bytes (or its extension when the bytes do not say): mostly `application/pdf`, also scanned images and forwarded e-mails (`message/rfc822`). Null when neither tells.
        - `bytes` integer, nullable, required: Size of the document in bytes.
        - `document_url` string, nullable, required: Our stored copy of the document, byte-identical to the original.
        - `source_document_url` string, nullable, required: The Superintendencia's own link to the document.
    - `administrative_acts` object[], required: The administrative acts (autos, sentencias, resoluciones) issued in the filing, each once.
      - `label` string, required: How the Superintendencia labels the act, e.g. `AU 53213 2025/05/20`.
      - `act_type` string, nullable, required: Type of act, as the Superintendencia abbreviates it: `AU` (auto), `SE` (sentencia), `RE` (resolución).
      - `act_number` string, nullable, required: Number of the act.
      - `issued_at` string, nullable, required: Date of the act, `yyyy-mm-dd`.
      - `file_name` string, required: The file name the Superintendencia published the document under, e.g. `25194793--0000000001.PDF`.
      - `content_type` string, nullable, required: The document's type, read from its bytes (or its extension when the bytes do not say): mostly `application/pdf`, also scanned images and forwarded e-mails (`message/rfc822`). Null when neither tells.
      - `bytes` integer, nullable, required: Size of the document in bytes.
      - `document_url` string, nullable, required: Our stored copy of the document, byte-identical to the original.
      - `source_document_url` string, nullable, required: The Superintendencia's own link to the document.
    - `documents_included` boolean, required: Whether documents were read for this answer (`include_documents`).

## Other responses

- `202`: Accepted — the result is being computed asynchronously. Poll `job.status_url` (GET /jobs/{id}) or supply `callback_url` to have the result POSTed to you. Returned when `Prefer: wait` elapses before completion, or immediately when `callback_url` is set.
- `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)