> ## 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.
# Superfinanciera Doctrina
> Busca en todos los conceptos y fallos jurisdiccionales de la Superintendencia Financiera de Colombia, y en las sentencias de las altas cortes que cataloga, con su texto completo, y lee cualquiera de ellos.
El catálogo de doctrina y jurisprudencia de la biblioteca de la Superintendencia Financiera de Colombia, cerca de 19.000 documentos: cada concepto que ha emitido desde 1994 (los de la Superintendencia Bancaria antes de 2005), cada fallo de su Delegatura para Funciones Jurisdiccionales y las sentencias de la Corte Constitucional, el Consejo de Estado y la Corte Suprema de Justicia que cataloga como jurisprudencia financiera. Cada uno llega con el resumen y los descriptores de la propia SFC, su número, fecha, emisor y expediente, su texto completo cuando el documento tiene texto, y los enlaces a la entrada y al documento en la Superintendencia.
Busca en todos a la vez, por colección, año, número, expediente, emisor, descriptor o fecha, o con texto libre que llega hasta el cuerpo de cada documento. Busca primero y luego lee un documento completo.
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/superfinanciera-doctrine/search/v1` Dataset
Una sola búsqueda sobre el texto completo de todos los conceptos desde 1994 y todos los fallos jurisdiccionales de la Superintendencia, filtrada por colección, año, número, expediente, emisor, descriptor, fecha o estado del texto.
| Campo | Tipo | Notas |
| --------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Palabras opcionales que se buscan en el número del documento, el expediente, el título, el resumen, los descriptores y el texto completo. |
| `collection` | enum | `concept` (conceptos, la doctrina de la SFC), `jurisdictional_ruling` (fallos de su Delegatura para Funciones Jurisdiccionales), `financial_case_law` (sentencias de las altas cortes que cataloga como jurisprudencia financiera), `other` o `any`. Por defecto `any`. |
| `year` | integer | Año opcional bajo el que la SFC archiva el documento (el año en que se expidió, en casi todos los casos). 0 busca en todos los años. Por defecto `0`. |
| `number` | string | Número opcional, como lo imprime la SFC: `2020311455-001`, `2017-1900`, `T-123`. No importan mayúsculas, espacios ni ceros a la izquierda. |
| `registration_number` | string | Expediente o radicado opcional de un fallo o una sentencia. No importan mayúsculas, espacios ni signos. |
| `issuer` | string | Emisor opcional, desde el inicio del nombre: `superintendencia financiera` (incluida su Delegatura), `superintendencia bancaria`, `corte constitucional`, `consejo de estado`, `corte suprema`. No importan mayúsculas ni tildes. |
| `topic` | string | Descriptor opcional, como lo publica la SFC en `topics`, p. ej. `PROTECCIÓN AL CONSUMIDOR FINANCIERO`. No importan mayúsculas ni tildes. |
| `from_date` | string | Opcional: solo documentos con fecha igual o posterior, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: solo documentos con fecha igual o anterior, `yyyy-mm-dd`. |
| `text_status` | enum | Opcional: `extracted` para los documentos cuyo texto completo está aquí, o `no_text_layer`, `audio`, `dead_link`, `withdrawn`, `no_document` o `any`. Por defecto `any`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-50). Por defecto `20`. |
```bash theme={"dark"}
curl https://api.croma.run/co/superfinanciera-doctrine/search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "consumidor financiero", "collection": "concept" }'
```
Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` (coincidencias en todas las páginas), `page`, `per_page`, `total_pages`, `count` y `results[]`, del más reciente al más antiguo. Cada resultado incluye `id` (el identificador del documento en el catálogo de la Superintendencia), `collection` (`concept`, `jurisdictional_ruling`, `financial_case_law` u `other`), `type` (`Concepto`, `Fallo` o `Sentencia`), `number` y `number_key`, `registration_number` y `registration_key` (el expediente o radicado), `year`, `issued_at`, `title`, `subject`, `summary` (el resumen de la propia SFC), `topics[]` y `topic_keys[]`, `issuer` e `issuer_key`, `reporting_judges[]` (el ponente de una sentencia), `series`, `notes`, `withdrawn_at`, `text_status`, `document_format`, `official_url` (la entrada en el catálogo de la Superintendencia) y `document_url` (el documento mismo).
`text_status` indica si el texto completo del documento está aquí: `extracted` (sí), `no_text_layer` (el documento es un escaneo, o está en un formato sin texto que leer), `audio` (una audiencia que la SFC publicó como grabación, como hizo con la mayoría de los fallos proferidos en audiencia), `dead_link` (el enlace de la SFC no lleva a un documento), `withdrawn` o `no_document`. Todas las entradas están aquí sea cual sea su estado, con `official_url` y, cuando lo hay, `document_url`.
Los resultados de búsqueda no incluyen el texto del documento, que llega a decenas de miles de caracteres. `query` sí busca dentro de él, así que una frase del cuerpo encuentra el documento; para leer el texto usa el endpoint Superfinanciera Doctrine Entry.
## Un documento, completo
`POST /co/superfinanciera-doctrine/entry/v1` Dataset
| Campo | Tipo | Notas |
| ---------- | ------- | --------------------------------------------------------------------------------------------------------------------------- |
| `entry_id` | string | **Obligatorio.** El `id` de los resultados de búsqueda, p. ej. `18717`. |
| `offset` | integer | Primer carácter del texto a devolver. Envía el `next_offset` de la respuesta anterior para seguir leyendo. Por defecto `0`. |
| `limit` | integer | Cuántos caracteres del texto devolver. La mayoría de los documentos caben en una sola respuesta. Por defecto `200000`. |
```bash theme={"dark"}
curl https://api.croma.run/co/superfinanciera-doctrine/entry/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "entry_id": "1" }'
```
Devuelve `as_of`, `found`, `entry_id` y `entry`, que trae todo lo que devuelve la búsqueda más `content`: una ventana sobre el texto completo del documento, con `text`, `offset`, `total_length`, `has_more` y `next_offset`. `content` es null salvo que `text_status` sea `extracted`. Cada resultado incluye `id` (el identificador del documento en el catálogo de la Superintendencia), `collection` (`concept`, `jurisdictional_ruling`, `financial_case_law` u `other`), `type` (`Concepto`, `Fallo` o `Sentencia`), `number` y `number_key`, `registration_number` y `registration_key` (el expediente o radicado), `year`, `issued_at`, `title`, `subject`, `summary` (el resumen de la propia SFC), `topics[]` y `topic_keys[]`, `issuer` e `issuer_key`, `reporting_judges[]` (el ponente de una sentencia), `series`, `notes`, `withdrawn_at`, `text_status`, `document_format`, `official_url` (la entrada en el catálogo de la Superintendencia) y `document_url` (el documento mismo).
Los fallos largos llegan a cientos de miles de caracteres, así que el texto se lee por rangos: envía `offset` y `limit`, y luego pasa el `next_offset` de la respuesta como `offset` hasta que `has_more` sea falso.
Un id que el catálogo no contiene devuelve `found: false` con HTTP 200, no un error.
Esquemas, todos los campos de respuesta y un playground interactivo.