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

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

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