Count contacts
Count contacts
Returns the total number of contacts (and distinct employer companies) matching the provided filters, without returning any contact data. Use this to gauge result set size before fetching with GET /contacts.
Quota cost: None — counts are always free.
Request
- Base URL: https://nordiccontacts.eu/api/v1
- URL: https://nordiccontacts.eu/api/v1/contacts/count
- Auth: HTTP bearer
Query parameters
Filter by country. This is mandatory. Get IDs from GET /countries.
Filter by a specific company (integer company ID from search results).
Filter by company business registration number.
Filter by region name (e.g. Uusimaa).
Comma-separated industry group IDs.
Comma-separated 5-digit TOL/NACE codes.
Filter by responsibility area IDs.
Comma-separated job function IDs.
Minimum company annual turnover in EUR thousands.
Maximum company annual turnover in EUR thousands.
Minimum company annual profit in EUR thousands.
Maximum company annual profit in EUR thousands.
Minimum company headcount.
Maximum company headcount.
Filter companies founded on or after this year.
Filter companies founded on or before this year.
Only include contacts added within this many days (1–3650).
Only include contacts with a new responsibility assignment within this many days.
Comma-separated organisation levels.
Webshop status: identified, not_identified, or not_crawled. Omitted imposes no restriction and includes 0 and NULL rows.
Comma-separated webshop platform names. Implies identified. Omitted includes all platforms and uncrawled rows.
Target market: b2b, b2c, both, unknown, or not_crawled. Omitted imposes no restriction and includes 0 and NULL rows.
Count only contacts with email / phone / both / either. Default: email.
Optional customer-list mode: exclude removes companies on your customer list, 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.
Response
Ok
Changes
No recorded changes to this operation across all 1 revision of this API.