> ## 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.
# Doctrina y jurisprudencia de Supersociedades
> Los conceptos jurídicos y sentencias de la Superintendencia de Sociedades con texto completo, sus providencias históricas, sus boletines y los avisos que publica, buscables y servidos desde la copia de Croma.
La Superintendencia de Sociedades publica su doctrina a través de su relatoría
(todos los conceptos jurídicos desde 1993 y todas las sentencias de la
Delegatura de Procedimientos Mercantiles, escritas u orales), publica cada
concepto jurídico y contable como PDF en su portal, conserva allí también miles
de providencias antiguas de insolvencia y mercantiles, emite un Boletín de
Conceptos Jurídicos mensual y las compilaciones de jurisprudencia de la
delegatura mercantil, y publica avisos de intervenciones, reorganizaciones y
liquidaciones más los autos de juzgados sobre procesos de insolvencia que le
piden publicar. Croma conserva los cinco como conjuntos de datos, con el texto
completo de los documentos de la relatoría y una copia de cada archivo que el
portal publica, y los sirve por palabras, descriptor, parte, consecutivo, fecha
y tipo.
La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye `as_of`: qué tan actualizados están los datos. [Cómo funcionan los datasets](/es/datasets).
## Buscar doctrina y jurisprudencia
`POST /co/supersociedades-relatoria/documents-search/v1` Dataset
Todos los conceptos jurídicos y todas las sentencias de la delegatura mercantil,
del más reciente al más antiguo, por palabras, tipo, descriptor, tema, parte o
fecha.
| 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 defecto `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 o cédula de una parte en una sentencia, solo dígitos. Los conceptos no tienen partes. |
| `consecutive` | string | El consecutivo, p. ej. `220-001087`. El mismo consecutivo encuentra el PDF del concepto en `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 defecto `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 defecto `1`. |
| `per_page` | integer | Rows per page, 1-100. Por defecto `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
}'
```
Devuelve `as_of`, `total` y `total_is_exact`, los campos de paginación y `results[]`, un documento cada uno:
| Campo | Notas |
| ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `id` | Identificador del documento; pásalo a `document` para el texto completo. |
| `content_type` | `legal_opinion`, `ruling`, `oral_ruling` o `topic`. |
| `title`, `ruling_title`, `subject`, `procedure` | Tal como los imprime la relatoría. |
| `consecutive`, `filing_id`, `case_number`, `year`, `decided_date`, `modified_date` | Consecutivo, radicado, número de proceso y fechas. |
| `descriptors`, `secondary_descriptors` | Los descriptores del tesauro. |
| `parties[]`, `party_document_numbers` | Las partes de una sentencia con sus documentos, tal como las lista la relatoría. |
| `legal_basis`, `text_length`, `video_url`, `source_url` | La norma en que se apoya la decisión, la extensión del texto, la grabación de una sentencia oral, y el documento en la relatoría. |
Una sentencia nombra a sus partes, personas naturales incluidas, tal como la
Superintendencia las publicó. La relatoría publica el texto de cada documento
y no un archivo, así que no hay `document_url`; las sentencias orales enlazan
su grabación en `video_url`.
## Un documento completo
`POST /co/supersociedades-relatoria/document/v1` Dataset
Todo lo que la relatoría tiene sobre un concepto o sentencia, texto incluido.
| Campo | Tipo | Notas |
| ----- | ------ | ---------------------------------------------------------------------------------- |
| `id` | string | **Obligatorio.** 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" }'
```
Devuelve `as_of`, `found`, `id` y `document`: cada campo de un resultado de búsqueda más `text`, `legal_sources[]` y `citations[]` (`type`, `source`, `status`, `link`), `questions[]` (`question`, `current_position`, `contrary_position`, `reiteration`) y `sections` (`background`, `facts`, `claims`, `considerations`, `costs`, `resolution`).
Un id que la copia no tiene devuelve `found: false` con HTTP 200.
## Buscar providencias históricas
`POST /co/supersociedades-relatoria/historical-rulings-search/v1` Dataset
Las providencias que el portal conserva como archivos, de la más reciente a la
más antigua, por colección, categoría, palabras o fecha.
| 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 defecto `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 defecto `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 defecto `1`. |
| `per_page` | integer | Rows per page, 1-100. Por defecto `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
}'
```
Devuelve `as_of`, `total` y `total_is_exact`, los campos de paginación y `results[]`, un archivo cada uno: `id`, `collection`, `title` (el radicado en insolvencia, el número de la sentencia en mercantiles), `description`, `category`, `dependency`, `procedure`, `subject`, `case_name`, `topic`, `year`, `issued_date`, `published_date`, `bytes`, `document_url` (nuestra copia) y `source_document_url` (la del portal).
El portal no ha agregado un archivo a estas carpetas desde diciembre de 2022;
la jurisprudencia vigente está en la relatoría (`documents-search`).
## Buscar conceptos en PDF
`POST /co/supersociedades-relatoria/opinion-files-search/v1` Dataset
Todos los conceptos jurídicos y contables que publica el portal, del más reciente
al más antiguo, por colección, palabras, consecutivo, año o fecha, con nuestra
copia del 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 defecto `any`. |
| `consecutive` | string | El consecutivo del oficio, p. ej. `220-001087`. El texto completo de un concepto jurídico está en `documents-search` bajo el mismo consecutivo. |
| `year` | integer | Optional year (1990 or later). 0 searches every year. Por defecto `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 defecto `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 defecto `1`. |
| `per_page` | integer | Rows per page, 1-100. Por defecto `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
}'
```
Devuelve `as_of`, `total` y `total_is_exact`, los campos de paginación y `results[]`, un archivo cada uno: `id`, `collection` (`legal` o `accounting`), `title`, `consecutive`, `subject` (el epígrafe), `issued_date`, `published_date`, `year`, `filing_id`, `dependency`, `procedure`, `in_force`, `bytes`, `document_url` (nuestra copia) y `source_document_url` (la del portal).
## Buscar boletines
`POST /co/supersociedades-relatoria/bulletins-search/v1` Dataset
Cada número, del más reciente al más antiguo, por serie, palabras o fecha.
| 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 defecto `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 defecto `1`. |
| `per_page` | integer | Rows per page, 1-100. Por defecto `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" }'
```
Devuelve `as_of`, `total` y `total_is_exact`, los campos de paginación y `results[]`, un número cada uno: `id`, `series` (`legal_opinions`, `accounting` o `jurisprudence`), `title`, `issue_date`, `published_date`, `summary`, `page_url`, `document_url` (nuestra copia), `source_document_url` y `bytes`.
Cuatro de los seis volúmenes del Boletín de Jurisprudencia están en un visor
externo y no en el portal: esos llevan el enlace del visor en
`source_document_url` y no tienen `document_url`.
## Buscar avisos
`POST /co/supersociedades-relatoria/notices-search/v1` Dataset
Cada aviso y auto que el portal publicó, del más reciente al más antiguo, por
tipo, palabras o fecha.
| 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 defecto `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 defecto `1`. |
| `per_page` | integer | Rows per page, 1-100. Por defecto `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 }'
```
Devuelve `as_of`, `total` y `total_is_exact`, los campos de paginación y `results[]`, un aviso cada uno: `id` (`notice:` o `order:`), `kind`, `title`, `published_date`, `expires_date`, `body_text` (el texto del aviso), `description` (la descripción del portal de un auto), `document_url` (nuestra copia del archivo principal), `source_document_url` y `documents[]` (cada archivo que el portal enlaza, con nuestra copia).
Los avisos nombran a la empresa o persona intervenida o liquidada, personas
naturales incluidas, tal como la Superintendencia los publicó.
## Un aviso
`POST /co/supersociedades-relatoria/notice/v1` Dataset
Un aviso o auto, con los mismos campos de un resultado de búsqueda.
| Campo | Tipo | Notas |
| ----- | ------ | ------------------------------------------------------------------------------------------------------------- |
| `id` | string | **Obligatorio.** 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" }'
```
Devuelve `as_of`, `found`, `id` y `notice`.
Un id que la copia no tiene devuelve `found: false` con HTTP 200.
Esquemas, todos los campos de respuesta y un playground interactivo.