Cognism
API integration

list_all_cognism_industry_codes

List industry codes in Cognism's dictionaries — SIC, NAICS, and ISIC codes mapped to industries. Returns the paginated code records with classification, code, label, and industry. classification is optional; when provided it must be one of sic, naics, isic.

list_all_cognism_technologies

List technologies from the Cognism technology dictionary. Filter with name (case-insensitive substring match). Returns the paginated envelope: data (array of technology records) and page (limit, nextCursor, hasMore in cursor mode; offset, total in offset mode). Max 100 per page, default 50; cursor and offset are mutually exclusive.

list_all_cognism_search_companies

Search Cognism companies by attribute, location, event (funding, acquisition, hiring, IPO), and intent filters. Returns one page of company records, each identified by its Cognism company UUID (uuid) plus the record's upstream attributes. Filter via the company and options body; options.sortFields (headcount or revenue) applies only with offset pagination. Max 100 per page. Costs one search token per row returned, regardless of view; an empty result page costs no tokens. Company searches never consume credits. Through Truto's proxy list API, pass the filter as query params (Truto moves them into the request body), e.g. company[name][include][]=Acme. Caveat (unverified live): Truto also moves `view` into the body, where Cognism may ignore it, so requested view segments might not be returned.

cognism_search_companies_count

Count the Cognism companies matching a company filter without retrieving records. Returns: total. Accepts the same company and options filter body as the companies search. Costs one search token per call, regardless of the total returned.

list_all_cognism_search_persons

Search Cognism persons by posting a structured person, company, and/or options filter. Returns one page of person records — redeemUuid/personUuid plus the segments selected via view (demographics, contacts, education, pastCompanies, skills, events). Max 100 per page; view=contacts reveals email addresses and phone numbers and costs one credit per record returned. Costs one search token per row returned, regardless of view; an empty result page costs no tokens. Through Truto's proxy list API, pass the filter as query params (Truto moves them into the request body), e.g. company[name][include][]=Acme. Caveat (unverified live): Truto also moves `view` into the body, where Cognism may ignore it, so requested view segments might not be returned.

cognism_search_persons_count

Count the Cognism persons matching a person and/or company filter without retrieving the records. Returns: total. Uses the same filter body as the person search. Costs one search token per call, regardless of the total returned.

list_all_cognism_countries

List countries from the Cognism dictionaries. Returns an unpaginated list of country records: id, name, isoAlpha2, regionId, and regionName. Optional filters: name (case-insensitive substring match) and regionId.

list_all_cognism_departments

List departments in Cognism. Returns department records ({id, name}) accepted by person and hiring-event filters, in a single unpaginated GET that costs no search tokens or credits.

list_all_cognism_industries

List industries from the Cognism dictionary. Returns industry taxonomy records with id, name, level, and parentId (links a child to its parent across the three-level taxonomy). No parameters are required.

list_all_cognism_regions

List the geographic regions available in Cognism's dictionary, used to resolve region filters (Africa, Americas, Asia, Europe, Oceania). Returns each region's id and name. Takes no parameters.

list_all_cognism_seniorities

List the seniority levels recognized by the Cognism dictionary API for use in person and hiring-event filters. Returns seniority records ({id, name}) for levels such as C-Suite, Vice President, Director, Manager, and Individual Contributor.

list_all_cognism_intent_topics

List the Bombora intent topic dictionary catalogue in Cognism. Supports filtering by name (case-insensitive substring match) and by id. Returns topic records with topicId and topicName; the catalogue returns an empty list in v1, with parameters accepted for forward compatibility.

list_all_cognism_account_intent_topics

List the intent topic IDs selected for your account in Cognism and the maximum number of topics the account may configure. Returns: topicIds, limit. No parameters required.

list_all_cognism_billing

Get the calling account's Cognism billing settings. Returns searchTokens (remaining, allotment, resetSeconds) and credits (allotment, resetSeconds). May fail with 503 when token usage cannot be read (enforcement disabled or store unavailable).

list_all_cognism_compliance_settings

Get the calling account's DNC-masking and geo-restriction compliance settings in Cognism. Returns dncRestrictedCountries (ISO alpha-2 codes where phone numbers are masked) and geoRestrictedCountries (countries excluded from search results).

list_all_cognism_personalization_settings

Get the calling account's personalization settings in Cognism. Returns intentTopics (selected intent topic ids) and technologies (watched technology names). No request parameters.

list_all_cognism_health

Check Cognism API service health with a lightweight probe. Returns an opaque health-probe payload whose fields are not documented upstream, so treat it as a liveness check rather than a data source. No required parameters; the endpoint is never rate limited.

create_a_cognism_tracked_company

Add companies to the Cognism tracked companies list so company webhooks deliver their events. Returns the full list as companyUuids. Required: companyUuids. A request that would push the list past 1,000 companies is rejected in full with 409.

delete_a_cognism_tracked_company_by_id

Remove one company from the Cognism tracked companies list by id (company UUID). Returns an empty 204 response on success. Required: id. Idempotent; removing a company stops future webhook deliveries only.

list_all_cognism_tracked_companies

List the tracked company UUIDs on the Cognism account — the companies whose events company webhooks deliver. Returns: companyUuids. The list is shared by every company webhook on the account and holds up to 1,000 companies.