--- title: "Supersociedades Company" method: POST path: "/co/supersociedades/company/v1" tags: ["Colombia", "Supersociedades"] --- # Supersociedades Company `POST /co/supersociedades/company/v1` ## Request - Base URL: `https://api.croma.run` - URL: `https://api.croma.run/co/supersociedades/company/v1` - Auth: HTTP bearer A company's whole history of filings with the Superintendencia de Sociedades by NIT: every fiscal year since 2015, newest first, each with its activity, location, supervision status and headline figures (revenue, profit, assets, liabilities, equity, cash flows, ratios, ranking) in thousands of COP. The preferred filing of each year comes first. Served by Croma (`as_of` says how current the data is). **Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`. ## Headers - `Idempotency-Key` string ## Request body - object - `document_number` string, required: Colombian NIT (numeric, no verification digit). 4-15 digits. ## Response `200` Successful response - SupersociedadesCompanyResponse - `data` SupersociedadesCompanyData, required - `as_of` string, nullable, required: How current the data in this response is. - `found` boolean, required: False when the NIT has no filing on record. - `document_number` string, required - `name` string, nullable, required: Razón social as filed most recently. - `fiscal_years` number[], required: Every fiscal year the company filed for, newest first. - `filings` object[], required: Every filing on record, newest first, the preferred filing of each year first. - `id` string, required: The filing's identifier: entry point, NIT and corte, e.g. `pymes_individuales_800011651_2025-12-31`. The same filing carries the same id in every Supersociedades dataset. - `document_number` string, required: The company's NIT, numeric, no verification digit. - `name` string, nullable, required: Razón social as filed. - `fiscal_year` integer, required: Fiscal year of the corte. - `cutoff_date` string, required: The corte, `yyyy-mm-dd`; December 31 for an annual filing. - `filing_id` string, nullable, required: Número de radicado of the filing. Numbers grow with time, so the highest one held for a corte is what a refresh reads above. - `statement_type` 'individual' | 'separado' | 'consolidado' | 'combinado', nullable, required: What the filing covers: `individual`, `separado`, `consolidado` or `combinado`. - `niif_group` 'plenas' | 'pymes', nullable, required: Reporting framework: `plenas` (group 1) or `pymes` (group 2). - `preferred` boolean, required: True for the one filing that stands for the company in that fiscal year: the individual books when filed, else the separado, else the consolidado, latest radicado first. Searches return preferred filings unless asked otherwise. - `ciiu_code` string, nullable, required: Primary CIIU Rev. 4 A.C. activity code as filed, four digits, e.g. `4220`. A prefix filter takes a division (`42`) or a full code. - `ciiu_description` string, nullable, required: The activity's label as filed. - `ciiu_section` string, nullable, required: CIIU section letter, `A` to `U`; `F` is construction. - `ciiu_division` string, nullable, required: CIIU two-digit division, e.g. `42`. - `sector` string, nullable, required: The CIIU division's label, e.g. `Obras de ingeniería civil`. - `macrosector` string, nullable, required: The Superintendencia's own grouping: `AGROPECUARIO`, `MINERO E HIDROCARBUROS`, `MANUFACTURA`, `CONSTRUCCION`, `COMERCIO`, `SERVICIOS`, `TRANSPORTE`, or `SIN CIIU`. - `region` string, nullable, required: Region as the Superintendencia groups departments, e.g. `Bogotá-Cundinamarca`, `Antioquia`, `Región Caribe`. - `department` string, nullable, required: Department of the company's domicile, as filed. - `city` string, nullable, required: City of the company's domicile, as filed. - `supervision_status` string, nullable, required: The company's standing before the Superintendencia: `INSPECCION`, `VIGILANCIA`, `CONTROL`, `CANCELADA`, `EXENTA`; null when the filing carries none. - `supervision_status_date` string, nullable, required: `yyyy-mm-dd` the supervision status was set. - `incorporation_date` string, nullable, required: Date of incorporation. - `employees_men` integer, nullable, required: Men employed, as filed. - `employees_women` integer, nullable, required: Women employed, as filed. - `revenue` number, nullable, required: Ingresos de actividades ordinarias for the fiscal year, in thousands of COP. - `gross_profit` number, nullable, required: Ganancia bruta, in thousands of COP. - `net_income` number, nullable, required: Ganancia (pérdida) for the fiscal year, in thousands of COP. - `total_assets` number, nullable, required: Total de activos at the corte, in thousands of COP. - `total_liabilities` number, nullable, required: Total pasivos at the corte, in thousands of COP. - `total_equity` number, nullable, required: Patrimonio total at the corte, in thousands of COP. - `revenue_previous` number, nullable, required: Revenue restated for the previous fiscal year. - `gross_profit_previous` number, nullable, required - `net_income_previous` number, nullable, required - `total_assets_previous` number, nullable, required - `total_liabilities_previous` number, nullable, required - `total_equity_previous` number, nullable, required - `comprehensive_income` number, nullable, required: Resultado integral total for the fiscal year, in thousands of COP. - `other_comprehensive_income` number, nullable, required: Otro resultado integral for the fiscal year, in thousands of COP. - `comprehensive_income_previous` number, nullable, required - `other_comprehensive_income_previous` number, nullable, required - `cash_from_operating` number, nullable, required: Net cash from operating activities, in thousands of COP. - `cash_from_investing` number, nullable, required - `cash_from_financing` number, nullable, required - `cash_from_operating_previous` number, nullable, required - `cash_from_investing_previous` number, nullable, required - `cash_from_financing_previous` number, nullable, required - `debt_ratio` number, nullable, required: Nivel de endeudamiento: total liabilities over total assets. - `liquidity` number, nullable, required: Razón de liquidez general. - `roa` number, nullable, required: Return on assets, as a fraction. - `roe` number, nullable, required: Return on equity, as a fraction. - `margin` number, nullable, required: Gross margin, as a fraction. - `ros` number, nullable, required: Return on sales (net income over revenue), as a fraction. - `debt_ratio_previous` number, nullable, required - `liquidity_previous` number, nullable, required - `roa_previous` number, nullable, required - `roe_previous` number, nullable, required - `rank_country` integer, nullable, required: The Superintendencia's ranking of the company by revenue among every filer that year; null when not ranked. - `rank_sector` integer, nullable, required: Ranking within its macrosector; null when not ranked. - `rank_top500` integer, nullable, required: Position among the 500 largest, when in it. - `rank_top9000` integer, nullable, required: Position among the 9,000 largest, when in it. - `rank_country_previous` integer, nullable, required: Previous year's ranking among every filer. - `rank_sector_previous` integer, nullable, required: Previous year's ranking within its macrosector. - `insolvency_processes_active` integer, nullable, required: Insolvency processes open at the corte, as the Superintendencia counts them. - `insolvency_processes_closed` integer, nullable, required: Insolvency processes closed, as the Superintendencia counts them. - `address` string, nullable, required: Address of the domicile, as filed. - `latitude` number, nullable, required: Latitude of the domicile as the Superintendencia geocodes it. - `longitude` number, nullable, required ## 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/df016cdb29d7?raw)