---
title: "Search companies"
method: GET
path: "/v1/company-data/search"
tags: ["Company data"]
---

# Search companies

`GET /v1/company-data/search`

Search companies by name or registration number.

---

#### See also  
Learn more about [Company data](./company-data-guide)

## Query parameters

- `country` string, alpha-2, required
- `name` string
- `registration_number` string

## Response `200`

Returns list of companies which matching

**ℹ️ Click to see full payload**

- CompanySearchList
  - `data` CompanySearch[], required
    - `country` string, alpha-2, required — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
    - `name` string, required
    - `search_ref` string, required — Opaque string, use it to fetch the information of this company via [Fetch company data](./company-data-fetch)
    - `registration_number` string, required
    - `address` Address, required
      - `street_address` string, nullable, required
      - `street_address_2` string, nullable, required
      - `postal_code` string, nullable, required
      - `city` string, nullable, required
      - `state` string, nullable, required
      - `region` string, nullable, required
      - `country` string, alpha-2, nullable, required — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
    - `disclosable` boolean, required — When `false`, indicate that the company information is not fully publicly available. Company data fetch will be partial
    - `status` 'live' | 'closed' | 'not_reported', required — Company status (live, closed, not_reported)

## Other responses

- `400` — The request is either malformed or contain invalid parameters.

---

[API](https://skmtc.net/dotfile/apis/api-specifications.md) · [All operations](https://skmtc.net/dotfile/apis/api-specifications/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dotfile/api-specifications/versions/36393567057b/schema)