Companies

List companies

List companies

Returns a paginated list of companies matching the provided filters. The response contains company-level fields only — no contacts are embedded. To retrieve contacts for a company, use GET /companies/{companyId}/contacts.

The companyContactFilter parameter controls which companies are included based on whether they have contacts with email / phone / both / all — it is a filter criterion, not a field selector.

The response is capped at your remaining quota if limit exceeds it.

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

get/companies

Request

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

Query parameters

countryIdinteger required

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

companyIdinteger

Filter to a specific company by its integer ID.

businessIdstring

Filter by 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.

jobFunctionIdsInt[]

Comma-separated job function IDs.

turnoverMininteger

Minimum annual turnover in EUR thousands.

turnoverMaxinteger

Maximum annual turnover in EUR thousands.

profitMininteger

Minimum annual profit in EUR thousands.

profitMaxinteger

Maximum annual profit in EUR thousands.

personnelMininteger

Minimum headcount.

personnelMaxinteger

Maximum headcount.

foundedYearMininteger

Founded on or after this year.

foundedYearMaxinteger

Founded on or before this year.

newContactsWithinDaysinteger

Only include companies that have gained new contacts within this many days (1–3650).

newResponsibilityAssignmentsWithinDaysinteger

Only include companies with new responsibility assignments within this many days.

organizationLevelsstring[]

Comma-separated 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. 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.

companyContactFilter'all' | 'email' | 'phone' | 'both'

Include only companies whose contacts have: email, phone, both, or all (no filter). 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 companies 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.