---
ref: tool:people-data-labs/enrich-person
name: Enrich a person
company: company:people-data-labs
workflows: [workflow:github-stargazers-outbound]
access: [api]
tags: [capability:enrich-contacts, category:data-provider, has:api]
docs: https://docs.peopledatalabs.com/docs/reference-person-enrichment-api
updated: 2026-09-29
---

# 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.

Note: Charged per match; no match returns 404. Set `required`, such as `work_email`, to be charged only for matches with the fields you need. On the free plan, emails, phone numbers and detailed locations come back as true/false flags.

## Set up

Use the first option your agent supports.

### API (official)

- Base URL: https://api.peopledatalabs.com
- Endpoint: `GET /v5/person/enrich`
- Auth: send the header `X-Api-Key: $PDL_API_KEY`
- Get a key: https://dashboard.peopledatalabs.com/api-keys
- Docs: https://docs.peopledatalabs.com/docs/authentication

Before anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.

## Rules

- Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
- Never print API keys.