---
title: "List contacts"
method: GET
path: "/contacts"
tags: ["Contacts"]
---

# List contacts

`GET /contacts`

## Request

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

List contacts

Returns a paginated list of contacts matching the provided filters. Country filter is mandatory.
All other filter parameters are optional and combinable. The response is capped at
your remaining quota if the requested `limit` exceeds it.

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

## Query parameters

- `countryId` integer, required
- `companyId` integer
- `businessId` string
- `regionName` string
- `industryGroupIds` Int[]
- `industryCodes` string[]
- `mainResponsibilityAreaIds` Int[]
- `jobFunctionIds` Int[]
- `turnoverMin` integer
- `turnoverMax` integer
- `profitMin` integer
- `profitMax` integer
- `personnelMin` integer
- `personnelMax` integer
- `foundedYearMin` integer
- `foundedYearMax` integer
- `newContactsWithinDays` integer
- `newResponsibilityAssignmentsWithinDays` integer
- `organizationLevels` string[]
- `webshopStatus` 'identified' | 'not_identified' | 'not_crawled'
- `webshopPlatforms` string[]
- `targetMarket` 'b2b' | 'b2c' | 'both' | 'unknown' | 'not_crawled'
- `contactInfoFilter` 'email' | 'phone' | 'both' | 'either'
- `customerListMode` 'ignore' | 'exclude' | 'limit'
- `limit` integer
- `offset` 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)