> ## 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. # Baranda Virtual de Supersociedades > Lo que la Superintendencia de Sociedades publica para las partes de sus procesos (estados, traslados, avisos, sentencias, autos, edictos) por empresa, NIT o radicado, más el expediente de una empresa leído en vivo. La Baranda Virtual es donde la Superintendencia de Sociedades notifica a las partes de sus procesos: los estados y traslados diarios de cada delegatura e intendencia regional, los avisos de reorganizaciones, liquidaciones e intervenciones, las sentencias de sus procesos especiales, y los autos, edictos y publicidad de su labor administrativa. Croma conserva cada publicación desde 2024 con la empresa o persona de la que trata, su NIT o cédula, el trámite, las fechas y una copia de los archivos del radicado, y la sirve por empresa, lista, dependencia, radicado y fecha. Tres consultas leen la propia fuente: el expediente de una empresa por NIT o cédula (su situación ante la Superintendencia, sus administradores, y las providencias y entradas de sus procesos), empresas por nombre, y un radicado con los relacionados. ## Buscar publicaciones `POST /co/supersociedades-baranda/publications-search/v1` Dataset Todos los estados, traslados, avisos, sentencias, autos, edictos y publicidad desde 2024, del más reciente al más antiguo, filtrados por empresa, lista, dependencia, radicado o fecha. | Campo | Tipo | Notas | | ----------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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`. Por defecto `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. Por defecto `1`. | | `per_page` | integer | Rows per page, 1-100. Por defecto `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 }' ``` Devuelve `as_of`, `total` y `total_is_exact`, los campos de paginación y `results[]`, una publicación cada uno, con `id` (`::`), `kind`, `dependency` y `dependency_name`, `document_url` (nuestra copia del archivo principal) y `documents[]` (cada archivo que la fuente lista para el radicado, con nuestra copia), además de: | Campo | Notas | | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `filing_id`, `file_number`, `previous_filing_id` | El radicado, el expediente al que pertenece y el radicado al que responde, tal como los imprime la fuente. | | `filed_date`, `filed_at` | Fecha del radicado, y su hora en hora de Bogotá cuando la fuente la registra. | | `procedure`, `procedure_code`, `process` | El trámite y el proceso tal como los nombra la fuente. | | `sequence` | Consecutivo de un estado o traslado, p. ej. `415-000374`. | | `company_name`, `company_document_number` | La empresa o persona de la que trata la fila, y su NIT o cédula. En los estados y traslados propios de la Superintendencia la empresa es la propia Superintendencia. | | `subject`, `description`, `status`, `term_days`, `pages` | Asunto, tipo de documento, estado, término y folios tal como los imprime la fuente. | | `city`, `department`, `country` | Dónde está la empresa, tal como lo imprime la fuente. | | `source_document_url` | El enlace del visor de la propia fuente a los archivos del radicado. | Una publicación sobre una persona natural (un comerciante en insolvencia, una persona intervenida) lleva el nombre y la cédula de esa persona tal como la Superintendencia los publicó. Los estados y traslados propios de la Superintendencia la nombran a ella como empresa; las partes están en el archivo. ## Un radicado publicado `POST /co/supersociedades-baranda/publication/v1` Dataset Todo lo que la copia tiene para un radicado, una fila por cada lista en la que apareció. | Campo | Tipo | Notas | | ----------- | ------ | ---------------------------------------------------------------------------------------- | | `filing_id` | string | **Obligatorio.** 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" }' ``` Devuelve `as_of`, `found`, `filing_id` y `results[]` con los mismos campos de un resultado de búsqueda. Un radicado que la copia no tiene devuelve `found: false` con HTTP 200. La copia empieza en enero de 2024; para un radicado más antiguo o muy reciente, lee la fuente con el endpoint `filing`. ## El expediente de una empresa `POST /co/supersociedades-baranda/company-file/v1` Lo que la Superintendencia tiene sobre una empresa o persona, leído de la fuente al momento de la consulta. | Campo | Tipo | Notas | | ----------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------- | | `document_number` | string | **Obligatorio.** NIT or cédula of the company or person, digits only, no verification digit. 4-15 digits. | | `page` | integer | Página de `decisions` y `filings`, diez cada una por página. La página 1 trae además la empresa y sus administradores. Por defecto `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" }' ``` Devuelve `found`, `document_number`, `company` (`name`, `short_name`, `company_type`, `registration_number`, `registration_date`, `incorporation_date`, `supervision_status` y su fecha, `situation` y su fecha, `stage`, `cause`, `ciiu_code`, `activity`, `purpose`, `address`, `department`, `city`, `file_number`), `officers[]` (`role`, `name`), y `decisions` y `filings`, cada uno con `total`, `page`, `per_page` (10) y `results[]`: | Campo | Notas | | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `filing_id`, `file_number`, `previous_filing_id` | El radicado, el expediente al que pertenece y el radicado al que responde, tal como los imprime la fuente. | | `filed_date`, `filed_at` | Fecha del radicado, y su hora en hora de Bogotá cuando la fuente la registra. | | `procedure`, `procedure_code`, `process` | El trámite y el proceso tal como los nombra la fuente. | | `sequence` | Consecutivo de un estado o traslado, p. ej. `415-000374`. | | `company_name`, `company_document_number` | La empresa o persona de la que trata la fila, y su NIT o cédula. En los estados y traslados propios de la Superintendencia la empresa es la propia Superintendencia. | | `subject`, `description`, `status`, `term_days`, `pages` | Asunto, tipo de documento, estado, término y folios tal como los imprime la fuente. | | `city`, `department`, `country` | Dónde está la empresa, tal como lo imprime la fuente. | | `source_document_url` | El enlace del visor de la propia fuente a los archivos del radicado. | Este endpoint es **asíncrono**: responde `202` con un `status_url` para consultar, o bloquea hasta el presupuesto de espera en línea (`Prefer: wait=N`). Envía un `callback_url` opcional para recibir el resultado por POST cuando termine. Ver la guía de trabajos asíncronos. Un número bajo el cual la Superintendencia no tiene empresa devuelve `found: false` con HTTP 200. ## Empresas por nombre `POST /co/supersociedades-baranda/company-search/v1` Las empresas con expediente en la Superintendencia cuyo nombre contiene las palabras, con los mismos campos de un expediente. | Campo | Tipo | Notas | | ---------- | ------- | -------------------------------------------------------------------------------------------- | | `query` | string | **Obligatorio.** Words of the company's name (razón social) or sigla, at least 3 characters. | | `page` | integer | 1-based page number for paginated results. Por defecto `1`. | | `per_page` | integer | Rows per page, 1-100. Por defecto `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" }' ``` Devuelve `query`, `total`, los campos de paginación y `results[]`, una empresa cada uno con los campos de `company` del expediente. Este endpoint es **asíncrono**: responde `202` con un `status_url` para consultar, o bloquea hasta el presupuesto de espera en línea (`Prefer: wait=N`). Envía un `callback_url` opcional para recibir el resultado por POST cuando termine. Ver la guía de trabajos asíncronos. La fuente busca las palabras en cualquier parte del nombre y responde todas las coincidencias de una vez; una palabra común puede coincidir con miles de empresas. Acota las palabras y luego lee el expediente por NIT. ## Un radicado, en vivo `POST /co/supersociedades-baranda/filing/v1` Lo que la Superintendencia tiene hoy sobre un radicado, y los radicados del mismo expediente. | Campo | Tipo | Notas | | ----------- | ------ | ---------------------------------------------------------------------------------------- | | `filing_id` | string | **Obligatorio.** 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" }' ``` Devuelve `found`, `radicado`, `filing` y `related[]`, cada fila con: | Campo | Notas | | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `filing_id`, `file_number`, `previous_filing_id` | El radicado, el expediente al que pertenece y el radicado al que responde, tal como los imprime la fuente. | | `filed_date`, `filed_at` | Fecha del radicado, y su hora en hora de Bogotá cuando la fuente la registra. | | `procedure`, `procedure_code`, `process` | El trámite y el proceso tal como los nombra la fuente. | | `sequence` | Consecutivo de un estado o traslado, p. ej. `415-000374`. | | `company_name`, `company_document_number` | La empresa o persona de la que trata la fila, y su NIT o cédula. En los estados y traslados propios de la Superintendencia la empresa es la propia Superintendencia. | | `subject`, `description`, `status`, `term_days`, `pages` | Asunto, tipo de documento, estado, término y folios tal como los imprime la fuente. | | `city`, `department`, `country` | Dónde está la empresa, tal como lo imprime la fuente. | | `source_document_url` | El enlace del visor de la propia fuente a los archivos del radicado. | Este endpoint es **asíncrono**: responde `202` con un `status_url` para consultar, o bloquea hasta el presupuesto de espera en línea (`Prefer: wait=N`). Envía un `callback_url` opcional para recibir el resultado por POST cuando termine. Ver la guía de trabajos asíncronos. Un radicado que la fuente no conoce devuelve `found: false` con HTTP 200. Esquemas, todos los campos de respuesta y un playground interactivo.