SIMEV

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.

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.

POST /co/simev/shareholders/v1 Dataset 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.

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

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.

Full reference

Schemas, all response fields, and an interactive playground.

Get Started

Request types

Countries

Full reference