> ## 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
> Los accionistas principales de cada emisor de valores inscrito ante la Superintendencia Financiera de Colombia, por NIT, en cada corte de junio y diciembre.
La Superintendencia Financiera de Colombia lleva el Registro Nacional de
Valores y Emisores (SIMEV), donde está inscrita toda empresa que emite valores
en Colombia: las empresas listadas en bolsa y, con ellas, la mayoría de los
bancos, aseguradoras y compañías de financiamiento del país. Cada emisor
reporta sus accionistas principales por clase de acción con su informe
financiero periódico. Croma conserva esas listas y las sirve por NIT, con el
historial de cortes que cada emisor ha reportado.
La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye `as_of`: qué tan actualizados están los datos. [Cómo funcionan los datasets](/es/datasets).
`POST /co/simev/shareholders/v1` Dataset
Los accionistas principales que un emisor reportó en un corte, y los cortes que
ha reportado.
| Campo | Tipo | Notas |
| ----------------- | ------ | --------------------------------------------------------------------------------------------------- |
| `document_number` | string | **Obligatorio.** NIT colombiano del emisor, numérico, sin dígito de verificación. 4-15 dígitos. |
| `cutoff_date` | string | Corte a leer, yyyy-mm-dd (un 30 de junio o 31 de diciembre). Omite para el más reciente 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" }'
```
Devuelve `as_of` (qué tan actualizados están los datos), `found`, `document_number`,
el `cutoff_date` respondido, `cutoff_dates[]` (todos los cortes registrados para el
emisor, del más reciente al más antiguo), el `issuer`, `count`, `shareholders[]` y
`totals[]`.
| Campo | Notas |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `issuer` | `code` (el código del emisor en el registro), `name` y `entity_type` (la categoría del registro, p. ej. `BC-Establecimiento Bancario`). |
| `shareholders[]` | Cada accionista principal: `document_type_code` y `document_number` tal como se reportaron, `name`, `nationality_code` (ISO 3166-1 numérico, `170` es Colombia) y `nationality`, y luego `ordinary_shares` y `ordinary_pct`, `privileged_shares` y `privileged_pct`, `preferred_shares` y `preferred_pct`. Los porcentajes son la participación en esa clase, de 0 a 100. |
| `totals[]` | El resumen del libro de accionistas del emisor, una línea por `concept` tal como lo reporta (acciones por clase, personas naturales y jurídicas, accionistas extranjeros y locales, rangos de concentración), con `shareholders` y `shares`. |
Los emisores reportan sus accionistas principales, normalmente los 25 mayores
por clase de acción, en los cortes de junio y diciembre; los accionistas
menores no aparecen por nombre, y `totals` es donde se cuenta el resto del
libro. Solo se cubren las empresas inscritas como emisores de valores (unas
110 con lista publicada, entre ellas la mayoría de los bancos del país);
cualquier otro NIT devuelve `found: false`. Un `cutoff_date` que el emisor no
reportó también devuelve `found: false`, con `cutoff_dates` listando los que
sí reportó.
Esquemas, todos los campos de respuesta y un playground interactivo.