> ## 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.
# Supersociedades Baranda Virtual
> What the Superintendencia de Sociedades publishes for the parties to its processes (estados, traslados, avisos, sentencias, autos, edictos) by company, NIT or radicado, plus a company's process file read live.
The Baranda Virtual is where the Superintendencia de Sociedades notifies the
parties to its processes: the daily estados and traslados of each delegatura
and intendencia regional, the avisos of reorganizations, liquidations and
interventions, the sentencias of its special proceedings, and the autos,
edictos and publicidad of its administrative work. Croma keeps every
publication since 2024 with the company or person it is about, its NIT or
cédula, the trámite, the dates and a copy of the files behind the radicado,
and serves it by company, list, dependencia, radicado and date. Three lookups
read the source itself: a company's file by NIT or cédula (its standing before
the Superintendencia, its officers, and the decisions and filings of its
processes), companies by name, and one radicado with the ones related to it.
## Search the publications
`POST /co/supersociedades-baranda/publications-search/v1` Dataset
Every estado, traslado, aviso, sentencia, auto, edicto and publicidad since
2024, newest first, filtered by company, list, dependencia, radicado or date.
| Field | Type | Notes |
| ----------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `document_number` | string | Optional NIT or cédula of the company or person the publication is about, digits only. |
| `query` | string | Optional words matched against the company or person name, the subject and the trámite of the publication. |
| `kind` | enum | Optional list to search: `estado`, `traslado`, `aviso`, `sentencia`, `auto`, `edicto`, `publicidad`, or `any`. Default `any`. |
| `dependency` | string | Optional dependencia code as the source keys its lists, e.g. `apoyoJudicialR` (reorganización y concordato), `apoyoJudicialL` (liquidaciones), `apoyoJudicialPM` (procedimientos mercantiles), `notificaciones`, `medellinNew`. Every publication carries its `dependency`. |
| `filing_id` | string | Optional número de radicado, `yyyy-01-nnnnnn`. |
| `file_number` | string | Optional expediente (process file) number as the source prints it. |
| `from_date` | string | Optional date filter in yyyy-mm-dd format. |
| `to_date` | string | Optional date filter in yyyy-mm-dd format. |
| `page` | integer | 1-based page number for paginated results. Default `1`. |
| `per_page` | integer | Rows per page, 1-100. Default `20`. |
```bash theme={"dark"}
curl https://api.croma.run/co/supersociedades-baranda/publications-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "kind": "aviso", "from_date": "2026-08-01", "per_page": 20 }'
```
Returns `as_of`, `total` and `total_is_exact`, paging fields, and `results[]`, one publication each, with `id` (`::`), `kind`, `dependency` and `dependency_name`, `document_url` (our copy of the main file) and `documents[]` (every file the source lists for the radicado, each with our copy), plus:
| Field | Notes |
| -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `filing_id`, `file_number`, `previous_filing_id` | The radicado, the expediente it belongs to, and the radicado it answers, as the source prints them. |
| `filed_date`, `filed_at` | Date of the radicado, and its time in Bogotá time when the source stamps one. |
| `procedure`, `procedure_code`, `process` | The trámite and the proceso as the source names them. |
| `sequence` | Consecutivo of an estado or traslado, e.g. `415-000374`. |
| `company_name`, `company_document_number` | The company or person the row is about, and its NIT or cédula. On the Superintendencia's own estados and traslados the company is the Superintendencia itself. |
| `subject`, `description`, `status`, `term_days`, `pages` | Asunto, document type, estado, término and folios as the source prints them. |
| `city`, `department`, `country` | Where the company is, as the source prints it. |
| `source_document_url` | The source's own viewer link for the radicado's files. |
A publication about a natural person (a merchant in insolvency, an
intervened person) carries that person's name and cédula as the
Superintendencia published them. The Superintendencia's own estados and
traslados name the Superintendencia as the company; the parties are in the
file itself.
## A published radicado
`POST /co/supersociedades-baranda/publication/v1` Dataset
Everything the copy holds for one radicado, one row per list it appeared under.
| Field | Type | Notes |
| ----------- | ------ | ------------------------------------------------------------------------------------- |
| `filing_id` | string | **Required.** Número de radicado as the Superintendencia prints it, `yyyy-01-nnnnnn`. |
```bash theme={"dark"}
curl https://api.croma.run/co/supersociedades-baranda/publication/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "filing_id": "2026-01-706561" }'
```
Returns `as_of`, `found`, `filing_id` and `results[]` with the same fields as a search result.
A radicado the copy does not hold returns `found: false` with HTTP 200. The
copy starts in January 2024; for an older or a very recent radicado, read the
source with the `filing` endpoint.
## A company's file
`POST /co/supersociedades-baranda/company-file/v1`
What the Superintendencia holds on a company or person, read from the source
at request time.
| Field | Type | Notes |
| ----------------- | ------- | -------------------------------------------------------------------------------------------------------------------- |
| `document_number` | string | **Required.** NIT or cédula of the company or person, digits only, no verification digit. 4-15 digits. |
| `page` | integer | Page of `decisions` and `filings`, ten each per page. Page 1 also carries the company and its officers. Default `1`. |
```bash theme={"dark"}
curl https://api.croma.run/co/supersociedades-baranda/company-file/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "document_number": "900553004" }'
```
Returns `found`, `document_number`, `company` (`name`, `short_name`, `company_type`, `registration_number`, `registration_date`, `incorporation_date`, `supervision_status` and its date, `situation` and its date, `stage`, `cause`, `ciiu_code`, `activity`, `purpose`, `address`, `department`, `city`, `file_number`), `officers[]` (`role`, `name`), and `decisions` and `filings`, each with `total`, `page`, `per_page` (10) and `results[]`:
| Field | Notes |
| -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `filing_id`, `file_number`, `previous_filing_id` | The radicado, the expediente it belongs to, and the radicado it answers, as the source prints them. |
| `filed_date`, `filed_at` | Date of the radicado, and its time in Bogotá time when the source stamps one. |
| `procedure`, `procedure_code`, `process` | The trámite and the proceso as the source names them. |
| `sequence` | Consecutivo of an estado or traslado, e.g. `415-000374`. |
| `company_name`, `company_document_number` | The company or person the row is about, and its NIT or cédula. On the Superintendencia's own estados and traslados the company is the Superintendencia itself. |
| `subject`, `description`, `status`, `term_days`, `pages` | Asunto, document type, estado, término and folios as the source prints them. |
| `city`, `department`, `country` | Where the company is, as the source prints it. |
| `source_document_url` | The source's own viewer link for the radicado's files. |
This endpoint is **asynchronous**: it answers `202` with a `status_url` to
poll, or blocks up to the inline-wait budget (`Prefer: wait=N`). Pass an
optional `callback_url` to have the result POSTed to you when it finishes.
See the async-jobs guide.
A number the Superintendencia holds no company under returns `found: false`
with HTTP 200.
## Companies by name
`POST /co/supersociedades-baranda/company-search/v1`
The companies the Superintendencia holds a file on whose name contains the
words, with the same fields as a company file.
| Field | Type | Notes |
| ---------- | ------- | ----------------------------------------------------------------------------------------- |
| `query` | string | **Required.** Words of the company's name (razón social) or sigla, at least 3 characters. |
| `page` | integer | 1-based page number for paginated results. Default `1`. |
| `per_page` | integer | Rows per page, 1-100. Default `20`. |
```bash theme={"dark"}
curl https://api.croma.run/co/supersociedades-baranda/company-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "TERRA BUNKERING" }'
```
Returns `query`, `total`, paging fields and `results[]`, one company each with the fields of `company` in the company file.
This endpoint is **asynchronous**: it answers `202` with a `status_url` to
poll, or blocks up to the inline-wait budget (`Prefer: wait=N`). Pass an
optional `callback_url` to have the result POSTed to you when it finishes.
See the async-jobs guide.
The source matches the words anywhere in the name and answers every match at
once; a common word can match thousands of companies. Narrow the words, then
read the file by NIT.
## A radicado, read live
`POST /co/supersociedades-baranda/filing/v1`
What the Superintendencia holds on one radicado today, and the radicados of
the same expediente.
| Field | Type | Notes |
| ----------- | ------ | ------------------------------------------------------------------------------------- |
| `filing_id` | string | **Required.** Número de radicado as the Superintendencia prints it, `yyyy-01-nnnnnn`. |
```bash theme={"dark"}
curl https://api.croma.run/co/supersociedades-baranda/filing/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "filing_id": "2026-01-706561" }'
```
Returns `found`, `radicado`, `filing` and `related[]`, each row with:
| Field | Notes |
| -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `filing_id`, `file_number`, `previous_filing_id` | The radicado, the expediente it belongs to, and the radicado it answers, as the source prints them. |
| `filed_date`, `filed_at` | Date of the radicado, and its time in Bogotá time when the source stamps one. |
| `procedure`, `procedure_code`, `process` | The trámite and the proceso as the source names them. |
| `sequence` | Consecutivo of an estado or traslado, e.g. `415-000374`. |
| `company_name`, `company_document_number` | The company or person the row is about, and its NIT or cédula. On the Superintendencia's own estados and traslados the company is the Superintendencia itself. |
| `subject`, `description`, `status`, `term_days`, `pages` | Asunto, document type, estado, término and folios as the source prints them. |
| `city`, `department`, `country` | Where the company is, as the source prints it. |
| `source_document_url` | The source's own viewer link for the radicado's files. |
This endpoint is **asynchronous**: it answers `202` with a `status_url` to
poll, or blocks up to the inline-wait budget (`Prefer: wait=N`). Pass an
optional `callback_url` to have the result POSTed to you when it finishes.
See the async-jobs guide.
A radicado the source does not know returns `found: false` with HTTP 200.
Schemas, all response fields, and an interactive playground.