---
title: "Supersociedades Largest Companies Search"
method: POST
path: "/co/supersociedades/largest-companies-search/v1"
tags: ["Colombia", "Supersociedades"]
---

# Supersociedades Largest Companies Search

`POST /co/supersociedades/largest-companies-search/v1`

## Request

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

The 10,000 largest companies in Colombia each fiscal year since 2021, as the Superintendencia de Sociedades publishes them, whichever superintendencia supervises them (Supersociedades, Superfinanciera, Supersalud, Superservicios, Supertransporte, Supervigilancia): searchable by name, year, macrosector, supervisor, CIIU and department. Each result is one company in one year: NIT, name, supervisor, region, department, city, CIIU, macrosector, rank, and revenue, profit, assets, liabilities and equity in billions of COP. By rank. Served by Croma (`as_of` says how current the data is); the latest year is searched when `fiscal_year` is 0.

**Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `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.
  - `macrosector` 'any' | 'agropecuario' | 'minero' | 'manufactura' | 'construccion' | 'comercio' | 'servicios' | 'transporte': Optional macrosector as the Superintendencia groups activities: `agropecuario`, `minero` (mining and hydrocarbons), `manufactura`, `construccion`, `comercio`, `servicios`, `transporte`, or `any`.
  - `supervisor` 'any' | 'supersociedades' | 'superfinanciera' | 'supersalud' | 'superservicios' | 'supertransporte' | 'supervigilancia': Optional supervisor of the company: `supersociedades`, `superfinanciera`, `supersalud`, `superservicios`, `supertransporte`, `supervigilancia`, or `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.
  - `per_page` integer: Results per page (1-100).

## Response `200`

Successful response

- SupersociedadesLargestCompaniesSearchResponse
  - `data` SupersociedadesLargestCompaniesSearchData, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `total` number, required: Matches across every page, counted up to 1000.
    - `total_is_exact` boolean, required: False when more than 1000 match: `total` is then 1000, and the pages go on.
    - `page` number, required
    - `per_page` number, required
    - `total_pages` number, required: Pages over `total`; there are more when `total_is_exact` is false.
    - `count` number, required: Results on this page.
    - `fiscal_year` number, nullable, required: The fiscal year searched: the one asked, or the latest available when `0` was sent.
    - `results` object[], required: By rank, largest revenue first.
      - `id` string, required: Fiscal year and NIT, e.g. `2025-899999068`.
      - `document_number` string, required: NIT, numeric, no verification digit.
      - `name` string, nullable, required: Razón social as published.
      - `supervisor` string, nullable, required: Which superintendencia supervises the company: `SUPERSOCIEDADES`, `SUPERFINANCIERA`, `SUPERSALUD`, `SUPERSERVICIOS`, `SUPERTRANSPORTE`, `SUPERVIGILANCIA`.
      - `region` string, nullable, required
      - `department` string, nullable, required: Department of domicile, as published.
      - `city` string, nullable, required
      - `ciiu_code` string, nullable, required: Primary CIIU code, four digits.
      - `ciiu_section` string, nullable, required
      - `ciiu_division` string, nullable, required
      - `sector` string, nullable, required: The CIIU division's label.
      - `macrosector` string, nullable, required: As published, uppercase with accents removed: `AGROPECUARIO`, `MINERO`, `MANUFACTURA`, `CONSTRUCCION`, `COMERCIO`, `SERVICIOS`.
      - `fiscal_year` integer, required
      - `rank` integer, required: Position that year by revenue, 1 for the largest.
      - `revenue` number, nullable, required: Ingresos operacionales, in billions (10^12) of COP as published, two decimals.
      - `profit` number, nullable, required: Ganancia (pérdida), in billions of COP.
      - `total_assets` number, nullable, required: In billions of COP.
      - `total_liabilities` number, nullable, required: In billions of COP.
      - `total_equity` number, nullable, required: In billions of COP.

## 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)