> ## 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.
# Doutrina e jurisprudência da Supersociedades
> Os conceitos jurídicos e sentenças da Superintendencia de Sociedades com texto completo, suas decisões históricas, seus boletins e os avisos que publica, pesquisáveis e servidos a partir da cópia da Croma.
A Superintendencia de Sociedades publica sua doutrina através de sua relatoría
(todos os conceitos jurídicos desde 1993 e todas as sentenças da Delegatura de
Procedimientos Mercantiles, escritas ou orais), publica cada conceito jurídico e
contábil como PDF em seu portal, mantém ali também milhares de decisões antigas
de insolvência e mercantis, emite um Boletín de Conceptos Jurídicos mensal e as
compilações de jurisprudência da delegatura mercantil, e publica avisos de
intervenções, reorganizações e liquidações mais os autos de juízos sobre
processos de insolvência que lhe pedem publicar. A Croma conserva os cinco como
conjuntos de dados, com o texto completo dos documentos da relatoría e uma
cópia de cada arquivo que o portal publica, e os serve por palavras, descritor,
parte, consecutivo, data e tipo.
A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](/pt/datasets).
## Buscar doutrina e jurisprudência
`POST /co/supersociedades-relatoria/documents-search/v1` Dataset
Todos os conceitos jurídicos e todas as sentenças da delegatura mercantil, do
mais recente ao mais antigo, por palavras, tipo, descritor, tema, parte ou
data.
| Campo | Tipo | Notas |
| ----------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Optional words matched against the title, the subject and the full text. |
| `content_type` | enum | Optional kind of document: `legal_opinion` (concepto jurídico), `ruling` (sentencia escrita), `oral_ruling` (sentencia en audiencia), `topic` (tema y problema), or `any`. Por padrão `any`. |
| `descriptor` | string | Optional main descriptor of the relatoría's thesaurus, exactly as it prints it, e.g. `Administradores`. |
| `subject` | string | Optional tema exactly as the relatoría names it, e.g. `Responsabilidad de los administradores`. |
| `party_document_number` | string | NIT ou cédula de uma parte em uma sentença, só dígitos. Os conceitos não têm partes. |
| `consecutive` | string | O consecutivo, ex. `220-001087`. O mesmo consecutivo encontra o PDF do conceito em `opinion-files-search`. |
| `filing_id` | string | Optional número de radicado, `yyyy-01-nnnnnn`. |
| `case_number` | string | Optional número de proceso as the Superintendencia prints it, e.g. `2019-800-00212`. |
| `year` | integer | Optional year (1990 or later). 0 searches every year. Por padrão `0`. |
| `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-relatoria/documents-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "abuso del derecho de voto",
"content_type": "ruling",
"per_page": 20
}'
```
Retorna `as_of`, `total` e `total_is_exact`, os campos de paginação e `results[]`, um documento cada:
| Campo | Notas |
| ---------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `id` | Identificador do documento; passe-o a `document` para o texto completo. |
| `content_type` | `legal_opinion`, `ruling`, `oral_ruling` ou `topic`. |
| `title`, `ruling_title`, `subject`, `procedure` | Tal como a relatoría os imprime. |
| `consecutive`, `filing_id`, `case_number`, `year`, `decided_date`, `modified_date` | Consecutivo, radicado, número do processo e datas. |
| `descriptors`, `secondary_descriptors` | Os descritores do tesauro. |
| `parties[]`, `party_document_numbers` | As partes de uma sentença com seus documentos, tal como a relatoría as lista. |
| `legal_basis`, `text_length`, `video_url`, `source_url` | A norma em que a decisão se apoia, a extensão do texto, a gravação de uma sentença oral, e o documento na relatoría. |
Uma sentença nomeia suas partes, pessoas naturais incluídas, tal como a
Superintendencia as publicou. A relatoría publica o texto de cada documento e
não um arquivo, então não há `document_url`; as sentenças orais linkam sua
gravação em `video_url`.
## Um documento completo
`POST /co/supersociedades-relatoria/document/v1` Dataset
Tudo o que a relatoría tem sobre um conceito ou sentença, texto incluído.
| Campo | Tipo | Notas |
| ----- | ------ | ---------------------------------------------------------------------------------- |
| `id` | string | **Obrigatório.** The document's identifier, as a search result carries it in `id`. |
```bash theme={"dark"}
curl https://api.croma.run/co/supersociedades-relatoria/document/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "id": "49850" }'
```
Retorna `as_of`, `found`, `id` e `document`: cada campo de um resultado de busca mais `text`, `legal_sources[]` e `citations[]` (`type`, `source`, `status`, `link`), `questions[]` (`question`, `current_position`, `contrary_position`, `reiteration`) e `sections` (`background`, `facts`, `claims`, `considerations`, `costs`, `resolution`).
Um id que a cópia não tem retorna `found: false` com HTTP 200.
## Buscar decisões históricas
`POST /co/supersociedades-relatoria/historical-rulings-search/v1` Dataset
As decisões que o portal conserva como arquivos, da mais recente à mais antiga,
por coleção, categoria, palavras ou data.
| Campo | Tipo | Notas |
| ------------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Optional words matched against the title, the subject and the full text. |
| `collection` | enum | Optional collection: `insolvency` (rulings of the insolvency delegatura), `mercantile` (rulings of the mercantile delegatura), or `any`. Por padrão `any`. |
| `category` | string | Optional category as the Superintendencia names it, e.g. `Liquidaciones`, `Reorganización`, `Régimen de Administradores`. |
| `year` | integer | Optional year (1990 or later). 0 searches every year. Por padrão `0`. |
| `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-relatoria/historical-rulings-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"collection": "mercantile",
"query": "administradores",
"per_page": 20
}'
```
Retorna `as_of`, `total` e `total_is_exact`, os campos de paginação e `results[]`, um arquivo cada: `id`, `collection`, `title` (o radicado em insolvência, o número da sentença em mercantis), `description`, `category`, `dependency`, `procedure`, `subject`, `case_name`, `topic`, `year`, `issued_date`, `published_date`, `bytes`, `document_url` (nossa cópia) e `source_document_url` (a do portal).
O portal não adicionou um arquivo a essas pastas desde dezembro de 2022; a
jurisprudência vigente está na relatoría (`documents-search`).
## Buscar conceitos em PDF
`POST /co/supersociedades-relatoria/opinion-files-search/v1` Dataset
Todos os conceitos jurídicos e contábeis que o portal publica, do mais recente ao
mais antigo, por coleção, palavras, consecutivo, ano ou data, com nossa cópia
do PDF.
| Campo | Tipo | Notas |
| ------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Optional words matched against the title, the subject and the full text. |
| `collection` | enum | Optional collection: `legal` (conceptos jurídicos), `accounting` (conceptos contables), or `any`. Por padrão `any`. |
| `consecutive` | string | O consecutivo do ofício, ex. `220-001087`. O texto completo de um conceito jurídico está em `documents-search` sob o mesmo consecutivo. |
| `year` | integer | Optional year (1990 or later). 0 searches every year. Por padrão `0`. |
| `in_force` | enum | Optional: `yes` for conceptos the Superintendencia marks as vigente, `no` for the ones it marks as no longer in force, or `any`. Por padrão `any`. |
| `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-relatoria/opinion-files-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"collection": "legal",
"query": "oficial de cumplimiento",
"per_page": 20
}'
```
Retorna `as_of`, `total` e `total_is_exact`, os campos de paginação e `results[]`, um arquivo cada: `id`, `collection` (`legal` ou `accounting`), `title`, `consecutive`, `subject` (a epígrafe), `issued_date`, `published_date`, `year`, `filing_id`, `dependency`, `procedure`, `in_force`, `bytes`, `document_url` (nossa cópia) e `source_document_url` (a do portal).
## Buscar boletins
`POST /co/supersociedades-relatoria/bulletins-search/v1` Dataset
Cada edição, da mais recente à mais antiga, por série, palavras ou data.
| Campo | Tipo | Notas |
| ----------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Optional words matched against the title, the subject and the full text. |
| `series` | enum | Optional series: `legal_opinions` (Boletín de Conceptos Jurídicos), `accounting` (Boletín de Conceptos Contables), `jurisprudence` (Boletín de Jurisprudencia and Libros de Jurisprudencia Societaria of the mercantile delegatura), or `any`. Por padrão `any`. |
| `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-relatoria/bulletins-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "series": "legal_opinions", "from_date": "2026-01-01" }'
```
Retorna `as_of`, `total` e `total_is_exact`, os campos de paginação e `results[]`, uma edição cada: `id`, `series` (`legal_opinions`, `accounting` ou `jurisprudence`), `title`, `issue_date`, `published_date`, `summary`, `page_url`, `document_url` (nossa cópia), `source_document_url` e `bytes`.
Quatro dos seis volumes do Boletín de Jurisprudencia estão em um visor externo
e não no portal: esses trazem o link do visor em `source_document_url` e não
têm `document_url`.
## Buscar avisos
`POST /co/supersociedades-relatoria/notices-search/v1` Dataset
Cada aviso e auto que o portal publicou, do mais recente ao mais antigo, por
tipo, palavras ou data.
| Campo | Tipo | Notas |
| ----------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Optional words matched against the title, the subject and the full text. |
| `kind` | enum | Optional kind of notice: `intervention`, `reorganization`, `judicial_liquidation`, `mandatory_liquidation`, `adjudication`, `special`, `general`, `court_order`, or `any`. Por padrão `any`. |
| `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-relatoria/notices-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "kind": "intervention", "from_date": "2026-01-01", "per_page": 20 }'
```
Retorna `as_of`, `total` e `total_is_exact`, os campos de paginação e `results[]`, um aviso cada: `id` (`notice:` ou `order:`), `kind`, `title`, `published_date`, `expires_date`, `body_text` (o texto do aviso), `description` (a descrição do portal de um auto), `document_url` (nossa cópia do arquivo principal), `source_document_url` e `documents[]` (cada arquivo que o portal linka, com nossa cópia).
Os avisos nomeiam a empresa ou pessoa intervinda ou liquidada, pessoas naturais
incluídas, tal como a Superintendencia os publicou.
## Um aviso
`POST /co/supersociedades-relatoria/notice/v1` Dataset
Um aviso ou auto, com os mesmos campos de um resultado de busca.
| Campo | Tipo | Notas |
| ----- | ------ | ------------------------------------------------------------------------------------------------------------- |
| `id` | string | **Obrigatório.** The notice's identifier, as a search result carries it in `id`: `notice:` or `order:`. |
```bash theme={"dark"}
curl https://api.croma.run/co/supersociedades-relatoria/notice/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "id": "notice:10086353" }'
```
Retorna `as_of`, `found`, `id` e `notice`.
Um id que a cópia não tem retorna `found: false` com HTTP 200.
Esquemas, todos os campos de resposta e um playground interativo.