All tools

Enrich a person

Returns one person's profile, with job title, employer, work history, education, skills and social profiles, plus work email and phone numbers on paid plans, matched from an email, phone, profile URL, or name and company.

View on GitHub
Updated Sep 27, 2026Available asAPI

Description

Charged per match; a request with no match returns 404. Raise `min_likelihood` (default 2) for stricter matches, and set `required`, such as `work_email`, so you are only charged for responses that include the fields you need. On the free plan, emails, phone numbers and detailed locations come back as true/false flags. To enrich up to 100 people in one request, use `POST /v5/person/bulk`.

enrich-person.md

Enrich a person

Returns one person's profile, with job title, employer, work history, education, skills and social profiles, plus work email and phone numbers on paid plans, matched from an email, phone, profile URL, or name and company.

Charged per match; a request with no match returns 404. Raise min_likelihood (default 2) for stricter matches, and set required, such as work_email, so you are only charged for responses that include the fields you need. On the free plan, emails, phone numbers and detailed locations come back as true/false flags. To enrich up to 100 people in one request, use POST /v5/person/bulk.

Set up

Use the first option your agent supports.

API (official)

Before doing anything else, make one read-only call to confirm access.

Rules

  • Ask the user before anything that sends messages, costs money, or changes data.
  • Never print API keys.

Built from these files in the repository

The layout and the rules come from lib/catalog/render-markdown.ts, the set-up wording from lib/catalog/render-access.ts.

Ways in

RouteSourceCallRequiredDocs
APIOfficialGET /v5/person/enrichAPI key in $PDL_API_KEYDocs

Workflows using Enrich a person

No workflows yet
No published workflow uses Enrich a person yet.