---
title: "Supersociedades Shareholders"
method: POST
path: "/co/supersociedades/shareholders/v1"
tags: ["Colombia", "Supersociedades"]
---

# Supersociedades Shareholders

`POST /co/supersociedades/shareholders/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/co/supersociedades/shareholders/v1`
- Auth: HTTP bearer

Shareholders or partners a Colombian company declared in the notes of its annual financial statements filed with the Superintendencia de Sociedades, by NIT: each holder's name, identity document, shares and percentage, plus the foreign investors, subsidiaries, associates and officers (legal representatives, accountant, revisor fiscal) declared in the same filing. Latest fiscal year by default, or a given year. Only companies that file with the Superintendencia (about 30,000 a year) are covered.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `document_number` string, required: Colombian NIT (numeric, no verification digit). 4-15 digits.
  - `year` integer: Optional fiscal year of the filing to read (2016 or later). 0 reads the latest filing.

## Response `200`

Successful response

- SupersociedadesShareholdersResponse
  - `data` SupersociedadesShareholdersData, required
    - `found` boolean, required: False when the NIT has no filing with these notes.
    - `document_number` string, required: Echoes the request's `document_number` (NIT, no check digit).
    - `company` object, nullable, required
      - `name` string, nullable, required
    - `filing` object, nullable, required
      - `year` number, required: Fiscal year of the filing.
      - `cutoff_date` string, required: Fiscal-year cutoff (yyyy-mm-dd).
      - `filing_id` string, nullable, required: Filing number (radicado).
      - `statement_type` 'individual' | 'separado' | 'consolidado' | 'combinado', nullable, required
      - `niif_group` 'plenas' | 'pymes', nullable, required
    - `shareholders` object[], required: Shareholders or partners as declared in the filing's notes.
      - `name` string, nullable, required: Name as declared.
      - `document_type` string, nullable, required: Identity document type as declared, e.g. "CEDULA DE CIUDADANIA", "NIT", "CEDULA DE EXTRANJERIA", "PASAPORTE".
      - `document_number` string, nullable, required: Identity document number or NIT as declared.
      - `country` string, nullable, required: Country as declared, e.g. "169 - COLOMBIA".
      - `shares` number, nullable, required: Shares or cuotas held, as declared.
      - `participation_pct` number, nullable, required: Share of the capital, in percent, as declared.
    - `foreign_investors` object[], required: Foreign investors as declared, when the filing carries that note.
      - `name` string, nullable, required: Name as declared.
      - `document_type` string, nullable, required: Identity document type as declared, e.g. "CEDULA DE CIUDADANIA", "NIT", "CEDULA DE EXTRANJERIA", "PASAPORTE".
      - `document_number` string, nullable, required: Identity document number or NIT as declared.
      - `country` string, nullable, required: Country as declared, e.g. "169 - COLOMBIA".
      - `shares` number, nullable, required: Shares held, as declared.
      - `participation_pct` number, nullable, required: Share of the capital, in percent, as declared.
      - `movement` string, nullable, required: Movement of the stake during the fiscal year, as declared.
    - `subsidiaries` object[], required: Companies this company controls, as declared.
      - `name` string, nullable, required
      - `document_number` string, nullable, required: The subsidiary's NIT, as declared.
      - `place_of_business` string, nullable, required
      - `country` string, nullable, required
      - `non_controlling_interest_pct` number, nullable, required: Share of the subsidiary's capital held by parties other than this company, in percent.
      - `non_controlling_voting_pct` number, nullable, required: Share of the subsidiary's voting rights held by parties other than this company, in percent.
    - `associates` object[], required: Companies this company holds a significant stake in, as declared.
      - `name` string, nullable, required
      - `document_number` string, nullable, required: The associate's NIT, as declared.
      - `place_of_business` string, nullable, required
      - `country` string, nullable, required
      - `ownership_pct` number, nullable, required: This company's share of the associate's capital, in percent.
      - `voting_pct` number, nullable, required: This company's share of the associate's voting rights, in percent.
    - `officers` object[], required: Legal representatives, accountant and revisor fiscal as declared.
      - `role` string, required: `legal_representative`, `first_alternate_legal_representative`, `second_alternate_legal_representative`, `accountant`, `statutory_auditor` (revisor fiscal), `alternate_statutory_auditor`, or the filing's own label.
      - `document_type` string, nullable, required
      - `document_number` string, nullable, required
      - `first_names` string, nullable, required
      - `last_names` string, nullable, required
      - `professional_card` string, nullable, required: Tarjeta profesional, for the accountant and the revisor fiscal.
      - `chamber_registration_date` string, nullable, required: Date the appointment was registered at the chamber of commerce, yyyy-mm-dd.

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/74c745980c60?raw)