SIC Filing

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}.

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

Headers

Idempotency-Keystring

Example:0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b

Optional client-chosen key for this request (any string up to 255 characters, e.g. a UUID). Every Croma operation is an idempotent lookup: repeating a request with the same body returns the same result and creates nothing, so retrying after a timeout or network failure is always safe. The key is echoed back in the Idempotency-Key response header so you can correlate a retry with its first attempt. Each attempt that reaches the API counts against the rate limit.

Preferstring

Example:wait=30

Set wait=N to hold the connection up to N seconds for an inline result. If the job finishes in time you get the normal 200 body; otherwise a 202 with a status_url to poll.

Request body

yearinteger required

Year of the filing (radicado), four digits, e.g. 2025.

case_numberstring required

Number of the filing (número de radicado) without the year, e.g. 194793.

case_controlstring

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_numberstring required

Document number (alphanumeric with hyphens allowed).

include_documentsboolean

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.

cacheboolean

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_urlstring uri

POST the job result here when it finishes.

Response

Successful response

Changes

No recorded changes to this operation across all 1 revision of this API.