> ## 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 da Supersociedades > O que a Superintendencia de Sociedades publica para as partes de seus processos (estados, traslados, avisos, sentenças, autos, editais) por empresa, NIT ou radicado, mais o expediente de uma empresa lido ao vivo. A Baranda Virtual é onde a Superintendencia de Sociedades notifica as partes de seus processos: os estados e traslados diários de cada delegatura e intendência regional, os avisos de reorganizações, liquidações e intervenções, as sentenças de seus processos especiais, e os autos, editais e publicidade de seu trabalho administrativo. A Croma conserva cada publicação desde 2024 com a empresa ou pessoa de que trata, seu NIT ou cédula, o trâmite, as datas e uma cópia dos arquivos do radicado, e a serve por empresa, lista, dependência, radicado e data. Três consultas leem a própria fonte: o expediente de uma empresa por NIT ou cédula (sua situação perante a Superintendencia, seus administradores, e as decisões e entradas de seus processos), empresas por nome, e um radicado com os relacionados. ## Buscar publicações `POST /co/supersociedades-baranda/publications-search/v1` Dataset Todos os estados, traslados, avisos, sentenças, autos, editais e publicidade desde 2024, do mais recente ao mais antigo, filtrados por empresa, lista, dependência, radicado ou data. | 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 padrão `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 padrão `1`. | | `per_page` | integer | Rows per page, 1-100. Por padrão `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 }' ``` Retorna `as_of`, `total` e `total_is_exact`, os campos de paginação e `results[]`, uma publicação cada, com `id` (`::`), `kind`, `dependency` e `dependency_name`, `document_url` (nossa cópia do arquivo principal) e `documents[]` (cada arquivo que a fonte lista para o radicado, com nossa cópia), além de: | Campo | Notas | | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | `filing_id`, `file_number`, `previous_filing_id` | O radicado, o expediente ao qual pertence e o radicado ao qual responde, tal como a fonte os imprime. | | `filed_date`, `filed_at` | Data do radicado, e sua hora no horário de Bogotá quando a fonte a registra. | | `procedure`, `procedure_code`, `process` | O trâmite e o processo tal como a fonte os nomeia. | | `sequence` | Consecutivo de um estado ou traslado, ex. `415-000374`. | | `company_name`, `company_document_number` | A empresa ou pessoa de que trata a linha, e seu NIT ou cédula. Nos estados e traslados da própria Superintendencia a empresa é a própria Superintendencia. | | `subject`, `description`, `status`, `term_days`, `pages` | Assunto, tipo de documento, estado, prazo e folhas tal como a fonte os imprime. | | `city`, `department`, `country` | Onde a empresa está, tal como a fonte o imprime. | | `source_document_url` | O link do visor da própria fonte para os arquivos do radicado. | Uma publicação sobre uma pessoa natural (um comerciante em insolvência, uma pessoa intervinda) traz o nome e a cédula dessa pessoa tal como a Superintendencia os publicou. Os estados e traslados da própria Superintendencia a nomeiam como empresa; as partes estão no arquivo. ## Um radicado publicado `POST /co/supersociedades-baranda/publication/v1` Dataset Tudo o que a cópia tem para um radicado, uma linha por cada lista em que apareceu. | Campo | Tipo | Notas | | ----------- | ------ | ---------------------------------------------------------------------------------------- | | `filing_id` | string | **Obrigatório.** 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" }' ``` Retorna `as_of`, `found`, `filing_id` e `results[]` com os mesmos campos de um resultado de busca. Um radicado que a cópia não tem retorna `found: false` com HTTP 200. A cópia começa em janeiro de 2024; para um radicado mais antigo ou muito recente, leia a fonte com o endpoint `filing`. ## O expediente de uma empresa `POST /co/supersociedades-baranda/company-file/v1` O que a Superintendencia tem sobre uma empresa ou pessoa, lido da fonte no momento da consulta. | Campo | Tipo | Notas | | ----------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------- | | `document_number` | string | **Obrigatório.** NIT or cédula of the company or person, digits only, no verification digit. 4-15 digits. | | `page` | integer | Página de `decisions` e `filings`, dez cada por página. A página 1 traz também a empresa e seus administradores. Por padrão `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" }' ``` Retorna `found`, `document_number`, `company` (`name`, `short_name`, `company_type`, `registration_number`, `registration_date`, `incorporation_date`, `supervision_status` e sua data, `situation` e sua data, `stage`, `cause`, `ciiu_code`, `activity`, `purpose`, `address`, `department`, `city`, `file_number`), `officers[]` (`role`, `name`), e `decisions` e `filings`, cada um com `total`, `page`, `per_page` (10) e `results[]`: | Campo | Notas | | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | `filing_id`, `file_number`, `previous_filing_id` | O radicado, o expediente ao qual pertence e o radicado ao qual responde, tal como a fonte os imprime. | | `filed_date`, `filed_at` | Data do radicado, e sua hora no horário de Bogotá quando a fonte a registra. | | `procedure`, `procedure_code`, `process` | O trâmite e o processo tal como a fonte os nomeia. | | `sequence` | Consecutivo de um estado ou traslado, ex. `415-000374`. | | `company_name`, `company_document_number` | A empresa ou pessoa de que trata a linha, e seu NIT ou cédula. Nos estados e traslados da própria Superintendencia a empresa é a própria Superintendencia. | | `subject`, `description`, `status`, `term_days`, `pages` | Assunto, tipo de documento, estado, prazo e folhas tal como a fonte os imprime. | | `city`, `department`, `country` | Onde a empresa está, tal como a fonte o imprime. | | `source_document_url` | O link do visor da própria fonte para os arquivos do radicado. | Este endpoint é **assíncrono**: responde `202` com um `status_url` para consultar, ou bloqueia até o orçamento de espera em linha (`Prefer: wait=N`). Envie um `callback_url` opcional para receber o resultado por POST quando terminar. Veja o guia de trabalhos assíncronos. Um número sob o qual a Superintendencia não tem empresa retorna `found: false` com HTTP 200. ## Empresas por nome `POST /co/supersociedades-baranda/company-search/v1` As empresas com expediente na Superintendencia cujo nome contém as palavras, com os mesmos campos de um expediente. | Campo | Tipo | Notas | | ---------- | ------- | -------------------------------------------------------------------------------------------- | | `query` | string | **Obrigatório.** 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 padrão `1`. | | `per_page` | integer | Rows per page, 1-100. Por padrão `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" }' ``` Retorna `query`, `total`, os campos de paginação e `results[]`, uma empresa cada com os campos de `company` do expediente. Este endpoint é **assíncrono**: responde `202` com um `status_url` para consultar, ou bloqueia até o orçamento de espera em linha (`Prefer: wait=N`). Envie um `callback_url` opcional para receber o resultado por POST quando terminar. Veja o guia de trabalhos assíncronos. A fonte busca as palavras em qualquer parte do nome e responde todas as coincidências de uma vez; uma palavra comum pode coincidir com milhares de empresas. Restrinja as palavras e depois leia o expediente por NIT. ## Um radicado, ao vivo `POST /co/supersociedades-baranda/filing/v1` O que a Superintendencia tem hoje sobre um radicado, e os radicados do mesmo expediente. | Campo | Tipo | Notas | | ----------- | ------ | ---------------------------------------------------------------------------------------- | | `filing_id` | string | **Obrigatório.** 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" }' ``` Retorna `found`, `radicado`, `filing` e `related[]`, cada linha com: | Campo | Notas | | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | `filing_id`, `file_number`, `previous_filing_id` | O radicado, o expediente ao qual pertence e o radicado ao qual responde, tal como a fonte os imprime. | | `filed_date`, `filed_at` | Data do radicado, e sua hora no horário de Bogotá quando a fonte a registra. | | `procedure`, `procedure_code`, `process` | O trâmite e o processo tal como a fonte os nomeia. | | `sequence` | Consecutivo de um estado ou traslado, ex. `415-000374`. | | `company_name`, `company_document_number` | A empresa ou pessoa de que trata a linha, e seu NIT ou cédula. Nos estados e traslados da própria Superintendencia a empresa é a própria Superintendencia. | | `subject`, `description`, `status`, `term_days`, `pages` | Assunto, tipo de documento, estado, prazo e folhas tal como a fonte os imprime. | | `city`, `department`, `country` | Onde a empresa está, tal como a fonte o imprime. | | `source_document_url` | O link do visor da própria fonte para os arquivos do radicado. | Este endpoint é **assíncrono**: responde `202` com um `status_url` para consultar, ou bloqueia até o orçamento de espera em linha (`Prefer: wait=N`). Envie um `callback_url` opcional para receber o resultado por POST quando terminar. Veja o guia de trabalhos assíncronos. Um radicado que a fonte não conhece retorna `found: false` com HTTP 200. Esquemas, todos os campos de resposta e um playground interativo.