SIMEV

A Superintendencia Financiera da Colômbia mantém o Registro Nacional de Valores y Emisores (SIMEV), onde está registrada toda empresa que emite valores na Colômbia: as empresas listadas em bolsa e, com elas, a maioria dos bancos, seguradoras e companhias de financiamento do país. Cada emissor reporta seus acionistas principais por classe de ação com seu relatório financeiro periódico. A Croma conserva essas listas e as serve por NIT, com o histórico de cortes que cada emissor reportou.

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.

POST /co/simev/shareholders/v1 Dataset Os acionistas principais que um emissor reportou em um corte, e os cortes que ele reportou.

Campo	Tipo	Notas
`document_number`	string	Obrigatório. NIT colombiano do emissor, numérico, sem dígito de verificação. 4-15 dígitos.
`cutoff_date`	string	Corte a ler, yyyy-mm-dd (um 30 de junho ou 31 de dezembro). Omita para o mais recente registrado.

curl https://api.croma.run/co/simev/shareholders/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_number": "860002964" }'

Retorna as_of (o quão atuais são os dados), found, document_number, o cutoff_date respondido, cutoff_dates[] (todos os cortes registrados para o emissor, do mais recente ao mais antigo), o issuer, count, shareholders[] e totals[].

Campo	Notas
`issuer`	`code` (o código do emissor no registro), `name` e `entity_type` (a categoria do registro, p. ex. `BC-Establecimiento Bancario`).
`shareholders[]`	Cada acionista principal: `document_type_code` e `document_number` tal como reportados, `name`, `nationality_code` (ISO 3166-1 numérico, `170` é a Colômbia) e `nationality`, e depois `ordinary_shares` e `ordinary_pct`, `privileged_shares` e `privileged_pct`, `preferred_shares` e `preferred_pct`. Os percentuais são a participação nessa classe, de 0 a 100.
`totals[]`	O resumo do livro de acionistas do emissor, uma linha por `concept` tal como ele o reporta (ações por classe, pessoas naturais e jurídicas, acionistas estrangeiros e locais, faixas de concentração), com `shareholders` e `shares`.

Os emissores reportam seus acionistas principais, normalmente os 25 maiores por classe de ação, nos cortes de junho e dezembro; os acionistas menores não aparecem por nome, e totals é onde o resto do livro é contado. Só são cobertas as empresas registradas como emissoras de valores (cerca de 110 com lista publicada, entre elas a maioria dos bancos do país); qualquer outro NIT retorna found: false. Um cutoff_date que o emissor não reportou também retorna found: false, com cutoff_dates listando os que ele reportou.

Referência completa

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

Primeiros passos

Tipos de solicitação

Países

Referência completa