Get Complete Person Info

Endpoint essentials
API key accessapi/v1/people/show or Master API key
OAuth scopesperson_read
Credit usage1 credit per person
Learn more about API pricing and credits.

Use the Get Complete Person Info endpoint to retrieve complete details about a person in the Apollo database, including employment history, location, and the full details of the person's current organization.

Reading the email field

This endpoint doesn't reveal verified emails for people you haven't saved as contacts. Instead of the address — and instead of nullemail contains the fixed placeholder [email protected], and every unrevealed person returns that same value.

Because the placeholder is a non-empty string, it passes checks that assume an email is either usable or absent:

  • Truthiness and null checks don't catch it. if (person.email) succeeds, so code may treat an unrevealed person as though you have their address.

  • email breaks as a dedupe or upsert key. Identical placeholders collapse unrelated people into one record.

email_status does not distinguish it either: it describes the address Apollo holds internally, so it reads verified even when email is the placeholder. Use it to judge deliverability once you have a real address, not to decide whether you have one. The field only ever returns one of three values — verified, extrapolated, or unavailable.

Recommended handling: compare email against the literal placeholder string and treat a match as "no email available yet". The response also omits contact_id and revealed_for_current_team for people who aren't your contacts, which is a useful second signal. To get the real address, call People Enrichment or Bulk People Enrichment, which never substitute the placeholder.

Person's situationemailemail_status
Verified email, not your contact[email protected]verified
Verified email, already your contactThe contact's real addressverified
No verified email, but Apollo holds an extrapolated addressThe extrapolated addressextrapolated
No email availablenullunavailable
Path Params
string
required

The Apollo ID for the person that you want to research.

To find person IDs, call the People Search endpoint and identify the id value for the person.

Example: 65f0a1b2c3d4e5f600012345

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/plain