Skip to main content
Contact enrichment: an identifier returns a full person record with name, headline, roles and educationContact enrichment: an identifier returns a full person record with name, headline, roles and education
Use this when you already know who a person is and want their full record from the Forager dataset.

Before you start

  • An API key and your Account ID. See Create an account.
  • One identifier for the person: a LinkedIn public identifier (the slug in linkedin.com/in/<slug>/) or a Forager ID (person_id).

Look up the person

Send a POST to Person detail lookup with either linkedin_public_identifier or person_id.
Set FORAGER_API_KEY and FORAGER_ACCOUNT_ID in your shell first, as in the quickstart. See Authentication. Change the identifier, or switch to the reverse lookup by email, to see the request in each language:

Read the response

The response is one person record: identity fields, location, linkedin_info, then roles (newest first), educations and the other profile lists, which are empty arrays when the profile has none. Click a field to see its type and meaning. The values are illustrative, not a real record.

How the lookups fit together

Every lookup starts from something that identifies the person. The person record carries an id, which the phone and personal email lookups accept as person_id. The work email lookup does not take a person_id: send a LinkedIn handle, or a first name, last name and company domain.
Enrichment flow: a LinkedIn handle, email or phone number returns a person record with an id; the id feeds the phone and personal email lookups, and a name with a company domain goes straight to the asynchronous work email lookupEnrichment flow: a LinkedIn handle, email or phone number returns a person record with an id; the id feeds the phone and personal email lookups, and a name with a company domain goes straight to the asynchronous work email lookup
If you already have a LinkedIn handle or a person_id and only need contact data, skip the person lookup and call the contact lookup directly.

Next steps

Last modified on November 1, 2026