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
Company APIs
A Note on Contact Locations
Last modified 27d ago