> ## 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
> Busque em todos os conceptos e fallos jurisdicionais da Superintendencia Financiera de Colombia, e nas sentenças das altas cortes que ela cataloga, com seu texto completo, e leia qualquer um deles.
O catálogo de doutrina e jurisprudência da biblioteca da Superintendencia Financiera de Colombia, cerca de 19.000 documentos: cada concepto que ela emitiu desde 1994 (os da Superintendencia Bancaria antes de 2005), cada fallo de sua Delegatura para Funciones Jurisdiccionales e as sentenças da Corte Constitucional, do Consejo de Estado e da Corte Suprema de Justicia que ela cataloga como jurisprudencia financiera. Cada um chega com o resumo e os descritores da própria SFC, seu número, data, emissor e expediente, seu texto completo quando o documento tem texto, e os links para a entrada e para o documento na Superintendencia.
Busque em todos de uma vez, por coleção, ano, número, expediente, emissor, descritor ou data, ou com texto livre que alcança o corpo de cada documento. Busque primeiro e depois leia um documento completo.
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/superfinanciera-doctrine/search/v1` Dataset
Uma única busca sobre o texto completo de todos os conceptos desde 1994 e de todos os fallos jurisdicionais da Superintendencia, filtrada por coleção, ano, número, expediente, emissor, descritor, data ou estado do texto.
| Campo | Tipo | Notas |
| --------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Palavras opcionais buscadas no número do documento, no expediente, no título, no resumo, nos descritores e no texto completo. |
| `collection` | enum | `concept` (conceptos, a doutrina da SFC), `jurisdictional_ruling` (fallos de sua Delegatura para Funciones Jurisdiccionales), `financial_case_law` (sentenças das altas cortes que ela cataloga como jurisprudencia financiera), `other` ou `any`. Por padrão `any`. |
| `year` | integer | Ano opcional sob o qual a SFC arquiva o documento (o ano em que foi expedido, em quase todos os casos). 0 busca em todos os anos. Por padrão `0`. |
| `number` | string | Número opcional, como a SFC o imprime: `2020311455-001`, `2017-1900`, `T-123`. Maiúsculas, espaços e zeros à esquerda são ignorados. |
| `registration_number` | string | Expediente ou radicado opcional de um fallo ou de uma sentença. Maiúsculas, espaços e pontuação são ignorados. |
| `issuer` | string | Emissor opcional, a partir do início do nome: `superintendencia financiera` (incluída sua Delegatura), `superintendencia bancaria`, `corte constitucional`, `consejo de estado`, `corte suprema`. Maiúsculas e acentos são ignorados. |
| `topic` | string | Descritor opcional, como a SFC o publica em `topics`, p. ex. `PROTECCIÓN AL CONSUMIDOR FINANCIERO`. Maiúsculas e acentos são ignorados. |
| `from_date` | string | Opcional: só documentos com data igual ou posterior, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: só documentos com data igual ou anterior, `yyyy-mm-dd`. |
| `text_status` | enum | Opcional: `extracted` para os documentos cujo texto completo está aqui, ou `no_text_layer`, `audio`, `dead_link`, `withdrawn`, `no_document` ou `any`. Por padrão `any`. |
| `page` | integer | Número da página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Resultados por página (1-50). Por padrão `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" }'
```
Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` (correspondências em todas as páginas), `page`, `per_page`, `total_pages`, `count` e `results[]`, do mais recente ao mais antigo. Cada resultado traz `id` (o identificador do documento no catálogo da Superintendencia), `collection` (`concept`, `jurisdictional_ruling`, `financial_case_law` ou `other`), `type` (`Concepto`, `Fallo` ou `Sentencia`), `number` e `number_key`, `registration_number` e `registration_key` (o expediente ou radicado), `year`, `issued_at`, `title`, `subject`, `summary` (o resumo da própria SFC), `topics[]` e `topic_keys[]`, `issuer` e `issuer_key`, `reporting_judges[]` (o relator de uma sentencia), `series`, `notes`, `withdrawn_at`, `text_status`, `document_format`, `official_url` (a entrada no catálogo da Superintendencia) e `document_url` (o próprio documento).
`text_status` indica se o texto completo do documento está aqui: `extracted` (está), `no_text_layer` (o documento é uma digitalização, ou está em um formato sem texto para ler), `audio` (uma audiência que a SFC publicou como gravação, como fez com a maioria dos fallos proferidos em audiência), `dead_link` (o link da SFC não leva a um documento), `withdrawn` ou `no_document`. Todas as entradas estão aqui qualquer que seja seu estado, com `official_url` e, quando existe, `document_url`.
Os resultados da busca não incluem o texto do documento, que chega a dezenas de milhares de caracteres. `query` busca dentro dele, então uma frase do corpo encontra o documento; para ler o texto use o endpoint Superfinanciera Doctrine Entry.
## Um documento, completo
`POST /co/superfinanciera-doctrine/entry/v1` Dataset
| Campo | Tipo | Notas |
| ---------- | ------- | ------------------------------------------------------------------------------------------------------------------------ |
| `entry_id` | string | **Obrigatório.** O `id` dos resultados da busca, p. ex. `18717`. |
| `offset` | integer | Primeiro caractere do texto a retornar. Envie o `next_offset` da resposta anterior para continuar lendo. Por padrão `0`. |
| `limit` | integer | Quantos caracteres do texto retornar. A maioria dos documentos cabe em uma resposta. Por padrão `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" }'
```
Retorna `as_of`, `found`, `entry_id` e `entry`, que traz tudo o que a busca retorna mais `content`: uma janela sobre o texto completo do documento, com `text`, `offset`, `total_length`, `has_more` e `next_offset`. `content` é null salvo quando `text_status` é `extracted`. Cada resultado traz `id` (o identificador do documento no catálogo da Superintendencia), `collection` (`concept`, `jurisdictional_ruling`, `financial_case_law` ou `other`), `type` (`Concepto`, `Fallo` ou `Sentencia`), `number` e `number_key`, `registration_number` e `registration_key` (o expediente ou radicado), `year`, `issued_at`, `title`, `subject`, `summary` (o resumo da própria SFC), `topics[]` e `topic_keys[]`, `issuer` e `issuer_key`, `reporting_judges[]` (o relator de uma sentencia), `series`, `notes`, `withdrawn_at`, `text_status`, `document_format`, `official_url` (a entrada no catálogo da Superintendencia) e `document_url` (o próprio documento).
As decisões longas chegam a centenas de milhares de caracteres, então o texto é lido por intervalos: envie `offset` e `limit`, depois passe o `next_offset` da resposta como `offset` até que `has_more` seja falso.
Um id que o catálogo não contém retorna `found: false` com HTTP 200, não um erro.
Esquemas, todos os campos de resposta e um playground interativo.