The person object

What each result looks like, with and without contact approval.

Without contact data#

The name is shortened to first name and last initial. Flags tell you whether an email, phone and LinkedIn profile exist.

json

{
  "id": "p_8f3a91c2",
  "name": "Jordan P.",
  "title": "VP of Sales",
  "department": "Sales",
  "level": "VP",
  "location": "Austin, TX, US",
  "company": {
    "name": "Northwind Cloud",
    "website": "northwindcloud.example",
    "industry": "Software Development",
    "size": "250-499",
    "revenue": "$10-50M",
    "phone": "+15125550100",
    "linkedin_url": "http://www.linkedin.com/company/northwind-cloud",
    "address": { "street": "100 Congress Ave, Ste. 200", "city": "Austin", "state": "TX", "postal_code": "78701", "country": "US" }
  },
  "has_email": true,
  "has_phone": true,
  "has_linkedin": true
}

With contact data#

Paid plans and accounts approved for contact data get the full name and these extra fields. The response says contact_fields_included: true. A paid plan gets the fields it bought: work email always, linkedin_url with LinkedIn URL, phone with Phone, and the full company with Company details (otherwise just its name and website). The response lists the rest in not_in_plan. We have a phone number for about 1 in 6 people, so with Phone many records still come without one. Personal email, full profiles, verification and hiring signals are not in API answers yet: our team sends them, and GET /v1/meta lists them under plan.sent_by_our_team.

json

{
  "id": "p_8f3a91c2",
  "name": "Jordan Patel",
  "title": "VP of Sales",
  "company": { "name": "Northwind Cloud", ... },
  ...
  "has_email": true,
  "has_phone": true,
  "has_linkedin": true,
  "email": "jordan.patel@northwindcloud.example",
  "email_verified_at": "2026-08-14",
  "phone": "+15125550134",
  "phone_type": "mobile",
  "linkedin_url": "https://www.linkedin.com/in/jordan-patel-example"
}

Field	Meaning
`id`	Stable person id. Use it with the batch endpoint.
`name`	"First L." without contact approval; full name with it.
`title`	Job title as listed.
`company`	Company details: `name`, `website`, `industry`, `size` (headcount bucket), `revenue` (range), main `phone`, `linkedin_url` (the company page) and office `address`. On a paid plan without Company details, only `name` and `website`.
`department`	Job family. See the filter values.
`level`	Seniority bucket.
`location`	City, state and country.
`has_email`	`has_phone`, `has_linkedin`: whether that detail is on file, shown to everyone.
`email`	Paid plans and contact approval. `email_verified_at` is when it was last checked.
`phone`	Contact approval, or a paid plan with Phone. `phone_type` says mobile or landline.
`linkedin_url`	Contact approval, or a paid plan with LinkedIn URL.