---
title: "RUES Entities by Name"
method: POST
path: "/co/rues/entities-by-name/v1"
tags: ["Colombia", "RUES"]
---

# RUES Entities by Name

`POST /co/rues/entities-by-name/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/co/rues/entities-by-name/v1`
- Auth: HTTP bearer

Search Colombian businesses in RUES by name, paginated, each result enriched with its full registry record.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `name` string, required: Entity name (razón social) to search for.
  - `page` integer: 1-based page number for paginated results.

## Response `200`

Successful response

- RuesEntitySearchResponse
  - `data` RuesEntitySearchData, required
    - `query` string, required
    - `capped` boolean, required
    - `entities` object[], required
      - `registry_id` string, nullable, required
      - `nit` string, nullable, required
      - `verification_digit` string, nullable, required
      - `name` string, nullable, required
      - `acronym` string, nullable, required
      - `chamber_code` string, nullable, required
      - `chamber_name` string, nullable, required
      - `registration_number` string, nullable, required
      - `registration_status` string, nullable, required
      - `legal_organization` string, nullable, required
      - `last_renewed_year` string, nullable, required
      - `category` string, nullable, required
      - `document_type` string, nullable, required
      - `detail` object, nullable, required
        - `registry_id` string, nullable, required
        - `nit` string, nullable, required
        - `verification_digit` string, nullable, required
        - `identification_class` string, nullable, required
        - `secondary_identification` string, nullable, required
        - `name` string, nullable, required
        - `acronym` string, nullable, required
        - `chamber_code` string, nullable, required
        - `chamber_name` string, nullable, required
        - `registration_number` string, nullable, required
        - `registration_status` string, nullable, required
        - `registration_category` string, nullable, required
        - `legal_organization` string, nullable, required
        - `society_type` string, nullable, required
        - `society_type_code` string, nullable, required
        - `registration_date` string, nullable, required
        - `last_renewal_date` string, nullable, required
        - `last_renewed_year` string, nullable, required
        - `expiration_date` string, nullable, required
        - `cancellation_date` string, nullable, required
        - `cancellation_reason` string, nullable, required
        - `updated_date` string, nullable, required
        - `primary_activity` object, required
          - `code` string, nullable, required
          - `description` string, nullable, required
        - `secondary_activity` object, required
          - `code` string, nullable, required
          - `description` string, nullable, required
        - `ciiu_3` object, required
          - `code` string, nullable, required
          - `description` string, nullable, required
        - `ciiu_4` object, required
          - `code` string, nullable, required
          - `description` string, nullable, required
        - `commercial_address` string, nullable, required
        - `commercial_municipality` string, nullable, required
        - `commercial_phones` string[], required
        - `commercial_email` string, nullable, required
        - `fiscal_address` string, nullable, required
        - `fiscal_municipality` string, nullable, required
        - `fiscal_phones` string[], required
        - `fiscal_email` string, nullable, required
        - `is_bic` boolean, nullable, required
        - `is_social_enterprise` boolean, nullable, required
        - `is_law_1780` boolean, nullable, required
        - `is_transport` boolean, nullable, required
        - `domain_forfeiture` boolean, nullable, required
        - `sipref_inactivation_control` boolean, nullable, required
        - `certificates_sale_url` string, nullable, required
    - `pagination` object, required
      - `total` integer, required
      - `page_size` integer, required
      - `total_pages` integer, required
      - `page` integer, 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)