Search Contacts

Search for contacts based on various criteria and retrieve preview data including names, job titles, and availability flags.

External Documentation

To learn more, visit the Cognism documentation.

​

Basic Parameters

Parameter	Description
Contact First Name	The contact first name to filter results by.
Contact Full Name	The contact full name to filter results by.
Contact IDs	A comma-separated list of contact IDs to filter results by.
Contact Job Functions	A comma-separated list of contact job functions to filter the retrieved results by.
Contact Job Titles	A comma-separated list of contact job titles to filter results by.
Contact Last Name	The contact last name to filter results by.
Contact Management Level	A comma-separated list of contact management levels to filter the retrieved results by.
Contact Seniority	A comma-separated list of contact seniority levels to filter the retrieved results by.
Exclude Contact Job Titles	A comma-separated list of contact job titles to exclude from the retrieved results.
Page	The page number to retrieve. Starts from 0.
Per Page	The maximum number of results to retrieve per page. Valid range is 1 - 100.
Return All Pages	Automatically fetch all resources, page by page.

​

Advanced Parameters

Parameter	Description
Additional Parameters	A 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="
		}
	]
}