Comment on page

People (Contact) APIs

Use the API playground at https://api.salesintel.io to test the API request and response patterns.
get
https://api.circleback.com
/service/people[/preview]
Retrieve contacts matching filter parameters (expand for details)
If your SalesIntel plan includes different pricing for Append vs Net-New contacts, you must include email or one of either first_name or last_name in your paid endpoint request. If a personal identifier is not included in your paid request, any records will be invoiced as net-new. A match_id from a /preview request is not a sufficient personal identifier.
Be sure to review the verified param to ensure that the contacts returned meet your accuracy requirements.
For requests that may return multiple contacts, consider using the /preview route to ensure that you are satisfied with the contact set being returned before using the credited route.
Response Model
{
"aggregations": {},
"batch_id": {},
"error": "string",
"is_preview": true,
"page": 0,
"page_size": 0,
"result_count": 0,
"search_results": [
{
"_score": {},
"addresses": [
{
"city": "string",
"country": "string",
"is_hq": true,
"location_id": 0,
"state": "string",
"street_1": "string",
"street_2": "string",
"type": "string",
"zip": "string"
}
],
"cds_batch_id": {},
"company": {
"actual_revenue": 0,
"domains": [
"string"
],
"id": 0,
"linkedin_url": "string",
"naics_codes": [
"string"
],
"name": "string",
"predicted_revenue": 0,
"revenue": 0,
"revenue_range": "string",
"sic_codes": [
"string"
],
"size": 0,
"size_range": "string"
},
"company_actual_revenue": 0,
"company_domains": [
"string"
],
"company_id": 0,
"company_name": "string",
"company_predicted_revenue": 0,
"company_revenue": 0,
"company_revenue_range": "string",
"company_score": {},
"company_size": 0,
"company_size_range": "string",
"company_status": {},
"dates": {
"created_date": "string",
"last_modified_date": "string"
},
"display_name": "string",
"doc_id": "string",
"email": "string",
"email_hash": "string",
"firmographic": {},
"first_name": "string",
"industry": "string",
"intent": {},
"is_executive": true,
"is_international": true,
"job_department": "string",
"job_level": "string",
"job_title": "string",
"last_name": "string",
"linkedin_url": {},
"location": "string",
"location_type": {},
"locations": {},
"logo_url": {},
"match_id": "string",
"naics_code": "string",
"other_emails": [
"string"
],
"person_id": 0,
"personal_addresses": [
{
"city": "string",
"country": "string",
"is_hq": true,
"location_id": 0,
"state": "string",
"street_1": "string",
"street_2": "string",
"type": "string",
"zip": "string"
}
],
"personal_email": "string",
"personal_email_hash": "string",
"phone_numbers": [
{
"country_code": "string",
"hash": "string",
"type": "string",
"value": "string"
}
],
"position_location_hashid": "string",
"position_location_id": 0,
"prefix": "string",
"primary_country": {},
"primary_domain": {},
"primary_name": {},
"relations": {},
"revenue_range": "string",
"sector": "string",
"sic_code": "string",
"size_range": "string",
"social_profiles": [
{
"type": "string",
"url": "string"
}
],
"specialties": {},
"status_reason": {},
"suffix": "string",
"tags": {},
"technographics": {},
"tier": 0,
"tier_counts": {},
"topics": [
{
"category": "string",
"topic_id": 0,
"topic_name": "string"
}
],
"verified": true
}
],
"sort_by": "string",
"sort_direction": "string",
"took": 0,
"total_count": 0,
"tracking_id": "string"
}

Enums

Job Departments

fnad - Finance/Administrative
hr - Human Resources
it_is - IT
lgl - Legal
mrkt - Marketing
ops - Operations
prc - Procurement
enrd - Engineering/R&D
sale - Sales/CS/Support
other - All Other

Job Levels

brd - Board Member
chf - C-Level
vp - Vice President
dir - Director
mgr - Manager
stf - other

Required Fields

address - any address
phone - any phone number
direct_phone - any direct line including work or mobile
any_mobile - a mobile number
personal_email - a personal email address
linkedin_url - a linkedin profile url
job_title - a job title

Response Reference

All Available Phone Type Values

work_hq
work_branch
work
mobile

All Available Social Type Values

linkedin
facebook
twitter