Superfinanciera

Duas coisas que a Superintendencia Financiera de Colombia publica. A primeira é sua normativa: cada Circular Externa, Carta Circular e Resolución expedida desde 2005, consultável por tipo e por ano em uma única busca, com a descrição oficial do que cada ato faz e o link para o próprio ato. A segunda é o histórico de actuaciones de uma demanda jurisdicional apresentada contra uma entidade supervisionada.

Buscar a normativa

POST /co/superfinanciera/regulations-search/v1 Dataset Uma única busca sobre circulares externas, cartas circulares e resoluciones de 2005 até hoje, algo que o site da Superintendencia não oferece.

Campo	Tipo	Notas
`query`	string	Palavras opcionais a buscar na descrição oficial do ato, sua citação e seu número.
`kind`	enum	`circular_externa` (instruções obrigatórias para as entidades supervisionadas), `carta_circular` (informativa, não cria obrigações), `resolucion` (ato administrativo) ou `any`. Por padrão `any`.
`year`	integer	Ano opcional em que o ato foi expedido, 2005 ou posterior. Omita ou envie 0 para buscar em todos os anos. Por padrão `0`.
`number`	string	Número exato opcional. Os zeros à esquerda são opcionais: `7` e `007` encontram o mesmo ato.
`bulletin`	string	Número opcional do Boletín del Ministerio de Hacienda y Crédito Público, Capítulo Superintendencia Financiera.
`issued_from`	string	Opcional: só atos expedidos nesta data ou depois, `yyyy-mm-dd`.
`issued_to`	string	Opcional: só atos expedidos nesta data ou antes, `yyyy-mm-dd`.
`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`.

curl https://api.croma.run/co/superfinanciera/regulations-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "riesgo de crédito", "kind": "circular_externa" }'

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, kind, number como a normativa o imprime, number_key (o mesmo número sem zeros à esquerda), year, issued_at, title (como o ato é citado), description (o que o ato faz, nas palavras da própria Superintendencia), bulletin (o número do Boletín del Ministerio de Hacienda y Crédito Público em que foi publicado), document_url, attachments[] e official_url.

Toda a normativa, de 2005 aos atos desta semana, pronta para consultar. Os atos permanecem onde a Superintendencia os publica: document_url é o endereço para ler um, e o formato do arquivo depende da época em que foi expedido.

Um ato

POST /co/superfinanciera/regulation/v1 Dataset

Campo	Tipo	Notas
`regulation_id`	string	Obrigatório. O `id` dos resultados da busca: tipo, ano e número, p. ex. `ce:2026:7`, `cc:2026:56`, `res:2026:1195`.

curl https://api.croma.run/co/superfinanciera/regulation/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "regulation_id": "ce:2026:7" }'

Retorna as_of, found, regulation_id e regulation. Cada resultado traz id, kind, number como a normativa o imprime, number_key (o mesmo número sem zeros à esquerda), year, issued_at, title (como o ato é citado), description (o que o ato faz, nas palavras da própria Superintendencia), bulletin (o número do Boletín del Ministerio de Hacienda y Crédito Público em que foi publicado), document_url, attachments[] e official_url.

Um id que a normativa não contém retorna found: false com HTTP 200, não um erro.

Solicitação

POST /co/superfinanciera/complaints/v1

Campo	Tipo	Notas
`document_number`	string	Obrigatório. 5-20 dígitos.
`filing_number`	string	Obrigatório. Exatamente 10 dígitos (o `numeroRadicación` da demanda).

curl https://api.croma.run/co/superfinanciera/complaints/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_number": "1234567890", "filing_number": "2024051440" }'

Resposta

actions é o histórico de actuaciones da demanda, uma entrada por etapa (da mais antiga à mais recente). Uma radicación sem demandas retorna um array vazio.

Campo	Notas
`action_date`	Data da actuación (`yyyy-mm-dd`), ou `null`.
`record_id`	Id da actuación, p. ex. `2024051440-001-000`.
`party`	Parte ou órgão envolvido (peticionário, dependência judicial ou a entidade).
`action`	A actuación realizada, p. ex. `AUTO ADMISORIO VERBAL SUMARIO`.
`attachments`	Documentos apresentados com a actuación, ou `null`.
`annexes`	Anexos da actuación, ou `null`.

Esta busca pode demorar mais que uma solicitação típica. É um trabalho assíncrono. Por padrão a solicitação espera de forma síncrona e retorna { data }, ou você pode fazer polling / usar um callback_url. Se não houver correspondências, retorna um array actions vazio, não um erro.

Referência completa

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

Primeiros passos

Tipos de solicitação

Países

Buscar a normativa

Um ato

Solicitação

Resposta

Referência completa

​Buscar a normativa

​Um ato

​Solicitação

​Resposta

Referência completa

Buscar a normativa

Um ato

Solicitação

Resposta