enrich_person

Find a person’s professional email address and/or mobile phone number. Provide at least one identifying field — LinkedIn URL is the most reliable.

Credits: 1 credit (email only) / 10 credits (with mobile)

Parameters

Name	Type	Required	Description
`linkedin_url`	string (url)	optional	LinkedIn profile URL, e.g. `https://linkedin.com/in/johndoe`
`email`	string	optional	Person’s known email address (used as a lookup key)
`person_id`	string	optional	Prospeo person_id from a prior `search_person` result
`first_name`	string	optional	First name (combine with `company_name` or `company_website`)
`last_name`	string	optional	Last name
`full_name`	string	optional	Full name — alternative to first_name + last_name
`company_name`	string	optional	Current employer name
`company_website`	string	optional	Company website, e.g. `https://acme.com`
`company_linkedin_url`	string (url)	optional	Company LinkedIn URL
`only_verified_email`	boolean	optional	Only return results when a verified email is found. Default: `false`
`enrich_mobile`	boolean	optional	Also look up the person’s mobile phone (costs 10 credits total). Default: `false`
`only_verified_mobile`	boolean	optional	Only return results when a verified mobile is found. Automatically enables `enrich_mobile`. Default: `false`

Provide at least one of: linkedin_url, email, or (first_name/full_name + company_name/company_website). Requests with no identifying data are rejected.

Example — by LinkedIn URL


{
  "linkedin_url": "https://linkedin.com/in/johndoe",
  "enrich_mobile": true
}

Example — by name + company


{
  "first_name": "Jane",
  "last_name": "Smith",
  "company_website": "https://acme.com",
  "only_verified_email": true
}

Response


{
  "success": true,
  "data": {
    "found": true,
    "free_enrichment": false,
    "person": {
      "person_id": "abc123",
      "full_name": "John Doe",
      "current_job_title": "VP of Engineering",
      "email": {
        "email": "john@acme.com",
        "status": "VERIFIED"
      },
      "mobile": {
        "mobile_international": "+14155552671",
        "mobile_country": "US",
        "status": "VERIFIED"
      },
      "location": {
        "city": "San Francisco",
        "country": "United States"
      },
      "skills": ["TypeScript", "AWS"],
      "job_history": [...]
    },
    "company": {
      "company_id": "xyz789",
      "name": "Acme Inc",
      "website": "https://acme.com",
      "industry": "SaaS",
      "employee_range": "51-200"
    }
  }
}

When no match is found:


{
  "success": true,
  "data": {
    "found": false,
    "message": "No person found matching the provided data points. Try adding more identifying information."
  }
}