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

> The principal shareholders of every securities issuer registered with Colombia's Superintendencia Financiera, by NIT, at each June and December cut-off.

The Superintendencia Financiera de Colombia keeps the Registro Nacional de
Valores y Emisores (SIMEV), where every company that issues securities in
Colombia is registered: the listed companies, and with them most of the
country's banks, insurers and financing companies. Each issuer reports its
principal shareholders per share class with its periodic financial report.
Croma keeps those lists and serves them by NIT, with the history of cut-offs
each issuer has reported.

<Note>
  The whole source, organized and ready to query: every endpoint on this page answers in milliseconds. Every response carries `as_of`: how current the data is. [How datasets work](/datasets).
</Note>

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

The principal holders an issuer reported at a cut-off, and the cut-offs it has
reported.

| Field             | Type   | Notes                                                                                      |
| ----------------- | ------ | ------------------------------------------------------------------------------------------ |
| `document_number` | string | **Required.** The issuer's Colombian NIT, numeric, no verification digit. 4-15 digits.     |
| `cutoff_date`     | string | Cut-off to read, yyyy-mm-dd (a June 30 or December 31). Omit for the latest one on record. |

```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" }'
```

Returns `as_of` (how current the data is), `found`, `document_number`, the
`cutoff_date` answered, `cutoff_dates[]` (every cut-off on record for the issuer,
newest first), the `issuer`, `count`, `shareholders[]` and `totals[]`.

| Field            | Notes                                                                                                                                                                                                                                                                                                                                             |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `issuer`         | `code` (the registry's own code for the issuer), `name` and `entity_type` (the registry's category, e.g. `BC-Establecimiento Bancario`).                                                                                                                                                                                                          |
| `shareholders[]` | Each principal holder: `document_type_code` and `document_number` as filed, `name`, `nationality_code` (ISO 3166-1 numeric, `170` is Colombia) and `nationality`, then `ordinary_shares` and `ordinary_pct`, `privileged_shares` and `privileged_pct`, `preferred_shares` and `preferred_pct`. Percentages are the share of that class, 0 to 100. |
| `totals[]`       | The issuer's share register summary, one line per `concept` as the issuer states it (shares per class, natural and legal persons, foreign and local holders, concentration bands), with `shareholders` and `shares`.                                                                                                                              |

<Note>
  Issuers report their principal holders, usually the top 25 per share class,
  at the June and December cut-offs; smaller holders are not listed by name,
  and `totals` is where the rest of the register is counted. Only companies
  registered as securities issuers are covered (about 110 with a published
  list, most of the country's banks among them); any other NIT returns
  `found: false`. A `cutoff_date` the issuer did not report returns
  `found: false` too, with `cutoff_dates` listing the ones it did.
</Note>

<Card title="Full reference" icon="code" href="/api-reference/overview">
  Schemas, all response fields, and an interactive playground.
</Card>