Skip to main content
Search for contacts based on various criteria and retrieve preview data including names, job titles, and availability flags.
External DocumentationTo learn more, visit the Cognism documentation.

​
Basic Parameters

ParameterDescription
Contact First NameThe contact first name to filter results by.
Contact Full NameThe contact full name to filter results by.
Contact IDsA comma-separated list of contact IDs to filter results by.
Contact Job FunctionsA comma-separated list of contact job functions to filter the retrieved results by.
Contact Job TitlesA comma-separated list of contact job titles to filter results by.
Contact Last NameThe contact last name to filter results by.
Contact Management LevelA comma-separated list of contact management levels to filter the retrieved results by.
Contact SeniorityA comma-separated list of contact seniority levels to filter the retrieved results by.
Exclude Contact Job TitlesA comma-separated list of contact job titles to exclude from the retrieved results.
PageThe page number to retrieve. Starts from 0.
Per PageThe maximum number of results to retrieve per page. Valid range is 1 - 100.
Return All PagesAutomatically fetch all resources, page by page.

​
Advanced Parameters

ParameterDescription
Additional ParametersA JSON object for additional body parameters. Values specified in this parameter will override equivalent parameters.

For example:
{
    “first_key”: 12345,
    “second_key”: “some_value”
}
The object must follow the vendor’s structure as defined in the API documentation.

​
Example Output

{
	"lastReturnedKey": "1714687499208_~34d633b7-41ea-3ac7-a280-431d71fd77eb",
	"totalResults": 1,
	"results": [
		{
			"id": "34d633b7-41ea-3ac7-a280-431d71fd77eb",
			"firstName": "Stjepan",
			"jobTitle": "Chief Innovation Officer",
			"account": {
				"name": "Cognism",
				"id": "efc6d975-8599-38ab-8cfe-e1c42ac16dc6",
				"hasOfficePhoneNumbers": true,
				"hasHqPhoneNumbers": false,
				"hasHiringEvent": true,
				"hasHeadcount": true,
				"hasSize": true,
				"hasLocation": true,
				"hasTechnologies": true,
				"hasType": true,
				"hasDomain": true,
				"hasIndustry": true,
				"hasRevenue": true,
				"hasLinkedinUrl": true,
				"hasWebsite": true,
				"hasFounded": true,
				"hasLastConfirmed": true,
				"hasNaics": true,
				"hasIsic": false,
				"hasSic": true,
				"hasShortDescription": true,
				"hasDescription": true
			},
			"lastName": "Buljat",
			"fullName": "Stjepan Buljat",
			"hasPreviousAccounts": true,
			"hasSkills": true,
			"hasLocationMoveEvent": false,
			"hasLinkedinUrl": true,
			"hasEmail": true,
			"hasEducation": true,
			"hasZip": false,
			"hasState": false,
			"hasCountry": true,
			"hasCity": false,
			"hasRegion": false,
			"hasJobLeaveEvent": true,
			"hasJobJoinEvent": true,
			"hasStreet": false,
			"hasDirectPhoneNumbers": false,
			"hasMobilePhoneNumbers": false,
			"hasPositionStartDate": true,
			"hasSeniority": false,
			"hasJobFunction": true,
			"hasManagementLevel": true,
			"hasLastConfirmed": true,
			"redeemId": "MzRkNjMzYjctNDFlYS0zYWM3LWEyODAtNDMxZDcxZmQ3N2ViO2IxMjBjOTdhLTlhNTItM2E3Zi1iNzNiLTg3MGUzYjQ0M2MxOTtlZmM2ZDk3NS04NTk5LTM4YWItOGNmZS1lMWM0MmFjMTZkYzY="
		}
	]
}

​
Workflow Library Example

Search Contacts with Cognism and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop