> ## 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.

# SIMEV

> Os acionistas principais de cada emissor de valores registrado na Superintendencia Financiera da Colômbia, por NIT, em cada corte de junho e dezembro.

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.

<Note>
  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).
</Note>

`POST /co/simev/shareholders/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

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. |

```bash theme={"dark"}
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`.                                                                                                                                |

<Note>
  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.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, todos os campos de resposta e um playground interativo.
</Card>