---
title: "Supersociedades Supervised Entities Search"
method: POST
path: "/co/supersociedades/supervised-entities-search/v1"
tags: ["Colombia", "Supersociedades"]
---

# Supersociedades Supervised Entities Search

`POST /co/supersociedades/supervised-entities-search/v1`

## Request

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

The roster of entities under the supervision of Colombia's Superintendencia de Sociedades at each year-end since 2021 (about 32,000 a year), searchable by name, NIT, standing (inspección, vigilancia, control, nueva) and department. Each result is one entity at one corte: NIT and check digit, name, standing, and the judicial notification address, department, city and email. Served by Croma (`as_of` says how current the data is); the latest corte 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.
  - `document_number` string: Optional Colombian NIT (numeric, no verification digit) to restrict the search to one company.
  - `supervision_status` 'any' | 'inspeccion' | 'vigilancia' | 'control' | 'cancelada' | 'exenta' | 'nueva' | 'camara_de_comercio': Optional standing before the Superintendencia: `inspeccion`, `vigilancia`, `control`, `cancelada`, `exenta`, `nueva` (roster only), `camara_de_comercio` (roster only), or `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.
  - `page` integer: 1-based page number for paginated results.
  - `per_page` integer: Results per page (1-100).

## Response `200`

Successful response

- SupersociedadesSupervisedEntitiesSearchResponse
  - `data` SupersociedadesSupervisedEntitiesSearchData, 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 corte year searched: the one asked, or the latest available when `0` was sent.
    - `results` object[], required: By name.
      - `id` string, required: Corte and NIT, e.g. `2025-12-31-890200122`.
      - `document_number` string, required: NIT, numeric, no verification digit.
      - `check_digit` string, nullable, required: Dígito de verificación, as published.
      - `name` string, nullable, required: Razón social as published.
      - `supervision_status` string, nullable, required: `INSPECCION`, `VIGILANCIA`, `CONTROL`, `NUEVA`, or `CAMARA COMERCIO INSPECCION-VIGILANCIA-CONTROL`; null when the row is misaligned at the source.
      - `address` string, nullable, required: Judicial notification address, as published.
      - `department` string, nullable, required
      - `city` string, nullable, required
      - `email` string, nullable, required: Judicial notification email, as published.
      - `cutoff_date` string, required: The corte of the snapshot the row belongs to.
      - `fiscal_year` integer, required
      - `misaligned` boolean, required: True when the source's row has its columns shifted beyond repair (no supervision status in either the status or the address column); the fields are then kept as published and `supervision_status` is null.

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