---
title: "Find companies by identity"
method: GET
path: "/companies/find"
tags: ["Companies"]
---

# Find companies by identity

`GET /companies/find`

## Request

- Base URL: `https://nordiccontacts.eu/api/v1`
- URL: `https://nordiccontacts.eu/api/v1/companies/find`
- Auth: HTTP bearer

Find companies by identity

Identity-resolves a company by name, business registration number, or
domain. At least one of the three parameters must be provided. Returns
ranked candidates with a `matchType` and relevance `score`.

Useful for enrichment workflows where you have partial company information
and want to identify the matching record.

**Quota cost:** 1 unit per returned candidate, minimum 1 per request.

## Query parameters

- `companyName` string
- `businessId` string
- `domain` string
- `countryId` integer
- `limit` integer

## Response `200`

Ok

- ApiEnvelopeRecordStringUnknown
  - `meta` object, required
    - `quota` object, required
      - `usedUnits` number, double, required
      - `remainingUnits` number, double, required
    - `pagination` object
      - `limit` number, double, required
      - `offset` number, double, required
    - `fieldNaming` 'camelCase', required
  - `data` RecordStringUnknown, required: Construct a type with a set of properties K of type T
  - `errors` ApiErrorItem[], required
    - `code` string, required
    - `message` string, required

---

[API](https://skmtc.dev/nordiccontacts/apis/nordiccontacts-rest-api.md) · [All operations](https://skmtc.dev/nordiccontacts/apis/nordiccontacts-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nordiccontacts/apis/nordiccontacts-rest-api/revisions/31f3fe4faf26?raw)