Contacts

List contacts

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.

get/contacts

Request

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

Query parameters

countryIdinteger required

Filter by country. This is mandatory. Get IDs from GET /countries.

companyIdinteger

Filter by a specific company (integer company ID from search results).

businessIdstring

Filter by company business registration number (e.g. Finnish Y-tunnus).

regionNamestring

Filter by region name (e.g. Uusimaa).

industryGroupIdsInt[]

Comma-separated industry group IDs. Get IDs from GET /industry-groups.

industryCodesstring[]

Comma-separated 5-digit TOL/NACE codes. Get codes from GET /industries.

mainResponsibilityAreaIdsInt[]

Filter by responsibility area IDs. Get IDs from GET /responsibility-areas.

jobFunctionIdsInt[]

Comma-separated job function IDs. Get IDs from GET /job-functions.

turnoverMininteger

Minimum company annual turnover in EUR thousands.

turnoverMaxinteger

Maximum company annual turnover in EUR thousands.

profitMininteger

Minimum company annual profit in EUR thousands.

profitMaxinteger

Maximum company annual profit in EUR thousands.

personnelMininteger

Minimum company headcount.

personnelMaxinteger

Maximum company headcount.

foundedYearMininteger

Filter companies founded on or after this year.

foundedYearMaxinteger

Filter companies founded on or before this year.

newContactsWithinDaysinteger

Only include contacts added within this many days (1–3650).

newResponsibilityAssignmentsWithinDaysinteger

Only include contacts with a new responsibility assignment within this many days.

organizationLevelsstring[]

Comma-separated organisation levels: Top Management, Middle Management, Experts, Secretary/Assistant.

webshopStatus'identified' | 'not_identified' | 'not_crawled'

Webshop status: identified, not_identified, or not_crawled. Omitted imposes no restriction and includes 0 and NULL rows.

webshopPlatformsstring[]

Comma-separated webshop platform names (e.g. shopify). Implies identified. Omitted includes all platforms and uncrawled rows.

targetMarket'b2b' | 'b2c' | 'both' | 'unknown' | 'not_crawled'

Target market: b2b, b2c, both, unknown, or not_crawled. Omitted imposes no restriction and includes 0 and NULL rows.

contactInfoFilter'email' | 'phone' | 'both' | 'either'

Only include contacts that have an email (email), phone (phone), both (both), or either (either). Default: email.

customerListMode'ignore' | 'exclude' | 'limit'

Optional customer-list mode: exclude removes companies on your customer list (net-new prospecting), limit returns only customer-list companies, ignore (or omitted) ignores the customer list. exclude/limit require an active customer list; fails with CUSTOMER_LIST_REQUIRED otherwise. Your account exclusion list always applies automatically.

limitinteger

Number of contacts to return (1–2000, default 100).

offsetinteger

Pagination offset (default 0).

Response

Ok

dataRecordStringUnknown required

Construct a type with a set of properties K of type T

Changes

No recorded changes to this operation across all 1 revision of this API.