Doutrina e jurisprudência da Supersociedades

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.

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

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

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

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

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

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

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:<n> ou order:<n>), 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:<n>` or `order:<n>`.

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.

Referência completa

Esquemas, todos os campos de resposta e um playground interativo.

Primeiros passos

Tipos de solicitação

Monitores

Países

Doutrina e jurisprudência da Supersociedades

Buscar doutrina e jurisprudência

Um documento completo

Buscar decisões históricas

Buscar conceitos em PDF

Buscar boletins

Buscar avisos

Um aviso

Referência completa

​Buscar doutrina e jurisprudência

​Um documento completo

​Buscar decisões históricas

​Buscar conceitos em PDF

​Buscar boletins

​Buscar avisos

​Um aviso

Referência completa

Buscar doutrina e jurisprudência

Um documento completo

Buscar decisões históricas

Buscar conceitos em PDF

Buscar boletins

Buscar avisos

Um aviso