Supersociedades

Returns what a Colombian company has filed with the Superintendencia de Sociedades: the annual financial statements (income statement, balance sheet and cash flow per fiscal year), and the notes of the same filing that declare its shareholders, foreign investors, subsidiaries, associates and officers. Around 30,000 companies file each year: those the Superintendencia supervises and those above its asset and revenue thresholds.

Shareholders and ownership

POST /co/supersociedades/shareholders/v1 Who owns the company, what it owns and who runs it, as the company itself declared in the notes of its latest filing.

Field	Type	Notes
`document_number`	string	Required. Colombian NIT, numeric, no verification digit. 4-15 digits.
`year`	integer	Fiscal year of the filing to read (2016 or later). Omit or send `0` for the latest filing. Default `0`.

curl https://api.croma.run/co/supersociedades/shareholders/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_number": "900249127" }'

The response describes one filing:

Field	Notes
`found`	`false` when the NIT has no filing with these notes for the year asked.
`document_number`	Echoes the requested NIT.
`company.name`	Name as filed.
`filing`	`year`, `cutoff_date`, `filing_id`, `statement_type` (`individual`, `separado`, `consolidado` or `combinado`) and `niif_group` (`plenas` or `pymes`) of the filing the notes belong to.
`shareholders[]`	Each holder’s `name`, `document_type`, `document_number`, `country`, `shares` and `participation_pct` (percent of the capital), as declared.
`foreign_investors[]`	Foreign holders as declared, with `movement` (what happened to the stake during the year).
`subsidiaries[]`	Companies this company controls: `name`, `document_number` (NIT), `place_of_business`, `country`, and the `non_controlling_interest_pct` and `non_controlling_voting_pct` held by others.
`associates[]`	Companies it holds a significant stake in, with `ownership_pct` and `voting_pct`.
`officers[]`	`role` (`legal_representative`, `first_alternate_legal_representative`, `accountant`, `statutory_auditor` for the revisor fiscal, and so on), names, identity document, `professional_card` and `chamber_registration_date`.

This is what the company declared in its own financial statements, not a registry entry: use it to corroborate and pre-fill, not as proof of ownership. Figures come exactly as filed. A company that files but declared no shareholders returns found: true with an empty shareholders array; a company that does not file with the Superintendencia (most small companies, and entities supervised elsewhere such as banks and insurers) returns found: false.

Financial statements

POST /co/supersociedades/financial-statements/v1

Field	Type	Notes
`document_number`	string	Required. Colombian NIT, numeric, no verification digit. 4-15 digits.

curl https://api.croma.run/co/supersociedades/financial-statements/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_number": "900249127" }'

The response returns one entry per fiscal year (latest filing per year, newest first, up to 10 years):

Field	Notes
`found`	`false` when the NIT has no filings on record.
`document_number`	Echoes the requested NIT.
`company`	Identity from the newest filing: `name`, `status`, `society_type`, `primary_activity` (CIIU `code` + `description`), `incorporation_date`, `city`, `department`, `registration_number`.
`count`	Fiscal years returned.
`capped`	`true` when the result cap was hit; results are then incomplete.
`statements[].year`	Fiscal year; `cutoff_date` is always December 31.
`statements[].filing_id`	Filing number; re-submissions replace earlier ones.
`statements[].statement_type`	What the filing covers: `individual`, `separado`, `consolidado` or `combinado`. Standalone (`individual`) filings are preferred when a year has several.
`statements[].niif_group`	Reporting framework: `plenas` (group 1) or `pymes` (group 2).
`statements[].reporting_unit`	Unit the filer declared for every figure. Filings for fiscal 2025 onward declare `MILES DE PESOS` (thousands of COP); earlier filings did not declare a unit, so it is `null`.
`statements[].income_statement`	`revenue`, `cost_of_sales`, `gross_profit`, `operating_profit`, `profit_before_tax`, `income_tax`, `net_income`, expense and finance lines.
`statements[].balance_sheet`	`total_assets`, `total_liabilities`, `total_equity`, current/non-current splits, cash, inventories, receivables, payables, capital.
`statements[].cash_flow`	`net_cash_from_operating`, `net_cash_from_investing`, `net_cash_from_financing`, plus `cash_at_start` and `cash_at_end`.

Figures come exactly as filed, in the filing’s reporting_unit. A concept the company did not report is null, and cash_flow can be null for filings without one. Not every Colombian company reports to Supersociedades: entities supervised elsewhere (banks and insurers, for example) will typically return found: false.

Search the companies

POST /co/supersociedades/companies-search/v1 Dataset Every company that reports to the Superintendencia, filtered by sector, place, status and size, largest first.

Field	Type	Notes
`query`	string	Optional words matched against the company name (razón social) as filed.
`fiscal_year`	integer	Optional fiscal year (2015 or later). 0 searches the latest year available. Default `0`.
`macrosector`	enum	Optional macrosector as the Superintendencia groups activities: `agropecuario`, `minero` (mining and hydrocarbons), `manufactura`, `construccion`, `comercio`, `servicios`, `transporte`, or `any`. Default `any`.
`ciiu_code`	string	Optional CIIU Rev. 4 A.C. filter: a section letter (`F` for construction), a two-digit division (`42`), or a full four-digit code (`4220`).
`department`	string	Optional department of the company’s domicile, e.g. `ANTIOQUIA`, `BOGOTA D.C.`. Case and accents are ignored.
`region`	enum	Optional region as the Superintendencia groups departments. Default `any`.
`supervision_status`	enum	Optional standing before the Superintendencia: `inspeccion`, `vigilancia`, `control`, `cancelada`, `exenta`, `nueva` (roster only), `camara_de_comercio` (roster only), or `any`. Default `any`.
`min_revenue`	number	Optional revenue floor for the fiscal year, in thousands of COP (`1000000` is one billion pesos). 0 applies no floor. Default `0`.
`include_all_filings`	boolean	`false` (default) returns one filing per company and fiscal year (the individual books when filed, else the separado, else the consolidado). `true` returns every filing, including consolidated ones. Default `false`.
`page`	integer	1-based page number for paginated results. Default `1`.
`per_page`	integer	Results per page (1-100). Default `20`.

curl https://api.croma.run/co/supersociedades/companies-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "macrosector": "construccion", "fiscal_year": 2025, "per_page": 20 }'

Returns as_of, fiscal_year (the year searched), total and total_is_exact, paging fields, and results[], one filing each:

Field	Notes
`id`, `filing_id`	The filing’s identifier and número de radicado. The same `id` names the filing in every Supersociedades dataset.
`document_number`, `name`	NIT and razón social as filed.
`fiscal_year`, `cutoff_date`	The corte; December 31 for an annual filing.
`statement_type`, `niif_group`, `preferred`	`individual`, `separado` or `consolidado`; `plenas` or `pymes`; whether this is the filing that stands for the company that year.
`ciiu_code`, `ciiu_section`, `ciiu_division`, `sector`, `macrosector`	The activity as filed and how the Superintendencia groups it.
`region`, `department`, `city`, `address`, `latitude`, `longitude`	The domicile.
`supervision_status`, `supervision_status_date`	`INSPECCION`, `VIGILANCIA`, `CONTROL`, `CANCELADA` or `EXENTA`, and since when.
`revenue`, `gross_profit`, `net_income`, `total_assets`, `total_liabilities`, `total_equity`	The fiscal year’s figures in thousands of COP, each with a `_previous` restatement of the year before.
`cash_from_operating`, `cash_from_investing`, `cash_from_financing`	Net cash flows, in thousands of COP.
`debt_ratio`, `liquidity`, `roa`, `roe`, `margin`, `ros`	Ratios as fractions.
`rank_country`, `rank_sector`, `rank_top500`, `rank_top9000`	The Superintendencia’s rankings by revenue, when ranked.
`employees_men`, `employees_women`, `insolvency_processes_active`, `insolvency_processes_closed`	As filed.

Only companies that file with the Superintendencia are here: those it supervises and those above its asset and revenue thresholds. Banks, insurers and other entities supervised elsewhere are not. Figures come as filed, in thousands of COP.

A company over time

POST /co/supersociedades/company/v1 Dataset Every year a company filed, with the same fields as a search result.

Field	Type	Notes
`document_number`	string	Required. Colombian NIT (numeric, no verification digit). 4-15 digits.

curl https://api.croma.run/co/supersociedades/company/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_number": "900249127" }'

Returns as_of, found, document_number, name (as filed most recently), fiscal_years[] (newest first) and filings[]: one row per filing, newest year first, the preferred filing of each year first.

A NIT with no filing on record returns found: false with HTTP 200.

Full statements of a filing

POST /co/supersociedades/filing-statements/v1 Dataset Every line the company filed, not only the headline figures.

Field	Type	Notes
`document_number`	string	Required. Colombian NIT (numeric, no verification digit). 4-15 digits.
`fiscal_year`	integer	Optional fiscal year of the filing to read (2016 or later). 0 reads the latest filing. Default `0`.
`statement_type`	enum	Which filing of the year to read: `preferred` (the individual books when filed, else the separado, else the consolidado), or one of `individual`, `separado`, `consolidado`, `combinado`. Default `preferred`.

curl https://api.croma.run/co/supersociedades/filing-statements/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_number": "900249127", "fiscal_year": 0 }'

Returns as_of, found, document_number, fiscal_years[] and filing:

Field	Notes
`reporting_unit`, `business_purpose`, `society_type`, `status`, `registration_number`, `incorporation_date`	From the cover.
`has_statutory_auditor`, `audited`, `auditor_opinion`, `restated`, `dividends_approved`, `has_investments_in_others`	The cover’s yes/no answers.
`cover[]`	Every cover field as filed: `concept`, `label`, `value`.
`balance_sheet`, `income_statement`, `comprehensive_income`, `cash_flow`	Headline figures with their `_previous` restatement, and `lines[]`: every line with a value, each with `code`, `group`, `label`, `current` and `previous`.
`indicators`	Leverage, debt ratio, working capital, current ratio, turnovers, EBITDA, ROA, ROE, solvency and year-on-year variations.
`equity_changes[]`, `equity_changes_totals[]`, `cash_breakdown[]`	The statement of changes in equity by component, and the cash subclassification.

found: false when the NIT has no filing for the year and statement type asked. Figures come exactly as filed, in thousands of COP.

Search by party

POST /co/supersociedades/ownership-search/v1 Dataset From a cédula or NIT to every filing that declares it, in any role.

Field	Type	Notes
`party_document_number`	string	Optional identity document or NIT of a person or company, numeric, as declared in the notes: finds the filings that declare it as a shareholder, officer or related company.
`party_role`	enum	Where to match `party_document_number`: among the `shareholder`s (and foreign investors), the `officer`s (legal representatives, accountant, revisor fiscal), the `related` companies (subsidiaries, associates, joint ventures), or `any`. Default `any`.
`query`	string	Optional words matched against the company name (razón social) as filed.
`fiscal_year`	integer	Optional fiscal year (2015 or later). 0 searches every year. Default `0`.
`include_all_filings`	boolean	`false` (default) returns one filing per company and fiscal year (the individual books when filed, else the separado, else the consolidado). `true` returns every filing, including consolidated ones. Default `false`.
`page`	integer	1-based page number for paginated results. Default `1`.
`per_page`	integer	Results per page (1-100). Default `20`.

curl https://api.croma.run/co/supersociedades/ownership-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "party_document_number": "900249127", "party_role": "any" }'

Returns as_of, total, total_is_exact, paging fields and results[], one filing each, with the filing identity (id, document_number, name, fiscal_year, cutoff_date, statement_type, preferred) and:

Field	Notes
`shareholders[]`	`name`, `document_type`, `document_number`, `country`, `shares`, `participation_pct`, as declared.
`foreign_investors[]`, `subsidiaries[]`, `associates[]`, `joint_ventures[]`	With their document number or NIT, country and percentages.
`officers[]`	`role`, names, identity document, `professional_card`, `chamber_registration_date`.
`investor_classes[]`	Counts and nominal values by class of investor, as declared.
`shareholder_document_numbers[]`, `officer_document_numbers[]`, `related_document_numbers[]`, `party_document_numbers[]`	Every document declared, by role and all together.

This is what each company declared in its own financial statements, not a registry: use it to corroborate and pre-fill, never as proof of ownership. A search with no party_document_number and no query lists the newest filings.

Parties of a filing

POST /co/supersociedades/filing-ownership/v1 Dataset The same fields as an ownership search result, for one filing.

Field	Type	Notes
`document_number`	string	Required. Colombian NIT (numeric, no verification digit). 4-15 digits.
`fiscal_year`	integer	Optional fiscal year of the filing to read (2016 or later). 0 reads the latest filing. Default `0`.
`statement_type`	enum	Which filing of the year to read: `preferred` (the individual books when filed, else the separado, else the consolidado), or one of `individual`, `separado`, `consolidado`, `combinado`. Default `preferred`.

curl https://api.croma.run/co/supersociedades/filing-ownership/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_number": "900249127", "fiscal_year": 0 }'

Returns as_of, found, document_number, fiscal_years[] and filing, with the fields described under the ownership search.

found: false when the NIT has no filing with these notes for the year and statement type asked.

Disclosure notes of a filing

POST /co/supersociedades/filing-disclosures/v1 Dataset What the company disclosed beyond the statements and the parties, note by note.

Field	Type	Notes
`document_number`	string	Required. Colombian NIT (numeric, no verification digit). 4-15 digits.
`fiscal_year`	integer	Optional fiscal year of the filing to read (2016 or later). 0 reads the latest filing. Default `0`.
`statement_type`	enum	Which filing of the year to read: `preferred` (the individual books when filed, else the separado, else the consolidado), or one of `individual`, `separado`, `consolidado`, `combinado`. Default `preferred`.

curl https://api.croma.run/co/supersociedades/filing-disclosures/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_number": "900249127", "fiscal_year": 0 }'

Returns as_of, found, document_number, fiscal_years[] and filing:

Field	Notes
`note_kinds[]`	Which notes the filing carries: `property_plant_equipment`, `intangibles`, `leases`, `payables`, `receivables`, `revenue_by_activity`, `expenses`, `income_and_expenses`, `other_provisions`, `impairment`, `biological_assets`, `biological_assets_and_investment_property`, `investment_property`, `aml_questionnaire`.
`notes[]`	One per note: `kind`, `form` (its title), `code`, `scalars[]` (facts filed without a member: `concept`, `label`, `value`, `period_end`) and `members[]` (`dimension`, `member`, `row`, `values[]`).
`aml_precious_metals`, `aml_virtual_asset_contributions`, `aml_virtual_asset_operations`, `aml_international_transactions`, `aml_state_contracts`	The questionnaire’s answers; null when the filing carries no questionnaire.
`consolidated_summary[]`	For a parent’s consolidated summary, every figure by dotted path.

Concepts are named as the reporting taxonomy names them (PropertyPlantAndEquipment, CxCTotalCuentasComercialesPorCobrarCorrientes), with the label the form prints. Values are as filed, numbers in thousands of COP.

Insolvency processes

POST /co/supersociedades/insolvency-processes-search/v1 Dataset Which companies are, or were, in reorganization or liquidation, as they reported it.

Field	Type	Notes
`document_number`	string	Optional Colombian NIT (numeric, no verification digit) to restrict the search to one company.
`query`	string	Optional words matched against the company name (razón social) as filed.
`process_type`	enum	Optional process type: `reorganizacion`, `liquidacion_judicial`, `acuerdos_de_reestructuracion` (Ley 550), `concordatos`, `liquidacion_obligatoria`, `validacion` (validación judicial de acuerdos), or `any`. Default `any`.
`active_only`	boolean	`true` returns only processes with no closing date reported. Default `false`.
`admitted_from`	string	Optional earliest admission date, `yyyy-mm-dd`, inclusive.
`admitted_to`	string	Optional latest admission date, `yyyy-mm-dd`, inclusive.
`page`	integer	1-based page number for paginated results. Default `1`.
`per_page`	integer	Results per page (1-100). Default `20`.

curl https://api.croma.run/co/supersociedades/insolvency-processes-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "process_type": "reorganizacion",
        "active_only": true,
        "per_page": 20
      }'

Returns as_of, total, total_is_exact, paging fields and results[]:

Field	Notes
`id`	NIT, admission date and process type.
`document_number`, `company_name`	The company, as the latest filing names it.
`process`	`REORGANIZACION`, `LIQUIDACION JUDICIAL`, `ACUERDOS DE REESTRUCTURACION`, `CONCORDATOS`, `LIQUIDACION OBLIGATORIA CREDITOS` or `VALIDACION`.
`stage`, `origin`	As reported, e.g. `CELEBRADO`, `POR SOLICITUD DEL DEUDOR`; `stage` is null when left blank.
`admission_date`, `closing_date`, `active`	`active` is true while no closing date is reported.
`reported_at`, `reported_in_year`	The corte of the latest filing that reports the process.

A process is what the company itself reported in its financial statements; the Superintendencia’s own case records are the authority on its stage.

The 10,000 largest

POST /co/supersociedades/largest-companies-search/v1 Dataset The country’s largest companies each year, including those supervised outside Supersociedades.

Field	Type	Notes
`query`	string	Optional words matched against the company name (razón social) as filed.
`fiscal_year`	integer	Optional fiscal year (2015 or later). 0 searches the latest year available. Default `0`.
`macrosector`	enum	Optional macrosector as the Superintendencia groups activities: `agropecuario`, `minero` (mining and hydrocarbons), `manufactura`, `construccion`, `comercio`, `servicios`, `transporte`, or `any`. Default `any`.
`supervisor`	enum	Optional supervisor of the company: `supersociedades`, `superfinanciera`, `supersalud`, `superservicios`, `supertransporte`, `supervigilancia`, or `any`. Default `any`.
`ciiu_code`	string	Optional CIIU Rev. 4 A.C. filter: a section letter (`F` for construction), a two-digit division (`42`), or a full four-digit code (`4220`).
`department`	string	Optional department of the company’s domicile, e.g. `ANTIOQUIA`, `BOGOTA D.C.`. Case and accents are ignored.
`page`	integer	1-based page number for paginated results. Default `1`.
`per_page`	integer	Results per page (1-100). Default `20`.

curl https://api.croma.run/co/supersociedades/largest-companies-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "fiscal_year": 2025, "macrosector": "construccion", "per_page": 20 }'

Returns as_of, fiscal_year, total, total_is_exact, paging fields and results[]:

Field	Notes
`id`, `document_number`, `name`	Year and NIT; razón social as published.
`supervisor`	`SUPERSOCIEDADES`, `SUPERFINANCIERA`, `SUPERSALUD`, `SUPERSERVICIOS`, `SUPERTRANSPORTE` or `SUPERVIGILANCIA`.
`region`, `department`, `city`, `ciiu_code`, `ciiu_section`, `ciiu_division`, `sector`, `macrosector`	As published.
`fiscal_year`, `rank`	Position that year by revenue, 1 for the largest.
`revenue`, `profit`, `total_assets`, `total_liabilities`, `total_equity`	In billions (10^12) of COP, two decimals, as published.

Figures here are in billions of pesos as the Superintendencia publishes this table, unlike the filings, which are in thousands.

Entities under supervision

POST /co/supersociedades/supervised-entities-search/v1 Dataset The supervision roster at each year-end: standing and where to notify.

Field	Type	Notes
`query`	string	Optional words matched against the company name (razón social) as filed.
`document_number`	string	Optional Colombian NIT (numeric, no verification digit) to restrict the search to one company.
`supervision_status`	enum	Optional standing before the Superintendencia: `inspeccion`, `vigilancia`, `control`, `cancelada`, `exenta`, `nueva` (roster only), `camara_de_comercio` (roster only), or `any`. Default `any`.
`department`	string	Optional department of the company’s domicile, e.g. `ANTIOQUIA`, `BOGOTA D.C.`. Case and accents are ignored.
`fiscal_year`	integer	Optional fiscal year (2015 or later). 0 searches the latest year available. Default `0`.
`page`	integer	1-based page number for paginated results. Default `1`.
`per_page`	integer	Results per page (1-100). Default `20`.

curl https://api.croma.run/co/supersociedades/supervised-entities-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "supervision_status": "vigilancia",
        "department": "ANTIOQUIA",
        "per_page": 20
      }'

Returns as_of, fiscal_year, total, total_is_exact, paging fields and results[]:

Field	Notes
`id`, `document_number`, `check_digit`, `name`	Corte and NIT; the NIT’s check digit; razón social as published.
`supervision_status`	`INSPECCION`, `VIGILANCIA`, `CONTROL`, `NUEVA` or `CAMARA COMERCIO INSPECCION-VIGILANCIA-CONTROL`.
`address`, `department`, `city`, `email`	The judicial notification address, as published.
`cutoff_date`, `fiscal_year`	The corte of the snapshot.
`misaligned`	True on the few rows the source publishes with shifted columns; `supervision_status` is then null and the fields are kept as published.

The roster lists supervised entities whether or not they filed statements that year, so it also finds companies the other Supersociedades searches do not.

Full reference

Schemas, all response fields, and an interactive playground.

Get Started

Request types

Monitors

Countries

Shareholders and ownership

Financial statements

Search the companies

A company over time

Full statements of a filing

Search by party

Parties of a filing

Disclosure notes of a filing

Insolvency processes

The 10,000 largest

Entities under supervision

Full reference

​Shareholders and ownership

​Financial statements

​Search the companies

​A company over time

​Full statements of a filing

​Search by party

​Parties of a filing

​Disclosure notes of a filing

​Insolvency processes

​The 10,000 largest

​Entities under supervision

Full reference

Shareholders and ownership

Financial statements

Search the companies

A company over time

Full statements of a filing

Search by party

Parties of a filing

Disclosure notes of a filing

Insolvency processes

The 10,000 largest

Entities under supervision