# PDL Person Enrich

> PDL Person Enrich is a paid API for AI agents from stable-people-data-git-shafu-pdl-api-settl-95fdf9-merit-systems.vercel.app, paid per call via x402, $0.28/call, status unknown (last checked 2026-09-15).

Enrich a person record with demographics, work history, education, contact info, social profiles, and skills using People Data Labs.

## Facts

- Endpoint: POST https://stable-people-data-git-shafu-pdl-api-settl-95fdf9-merit-systems.vercel.app/api/pdl/person/enrich
- Price: $0.28/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pdl-person-enrich-2d6992ae
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vIlvizVXtEmddmIXoNKdK

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability pdl-person-enrich-2d6992ae -d '<json body>'
```

Example prompt: Can you enrich this lead for me — her name is Sarah Chen, email is sarah.chen@acmecorp.com, and she works at Acme Corp? I want her full work history, education, social profiles, and skills, and only return results with a confidence score of at least 6.

## When to prefer this

Use this endpoint when you need to enrich a known individual's record starting from a partial identifier (email, phone, LinkedIn URL, name+company) and want comprehensive professional profile data including work history, education, skills, and contact info. Prefer this over person search when you already have a specific individual in mind rather than running a broad query across the database. Best for CRM enrichment, sales lead qualification, recruiting research, and identity resolution use cases where People Data Labs' 3B+ person database coverage is needed.

## Known failure modes

- Insufficient identifiers provided — returns 404 or low-likelihood match if only weak signals (e.g. name alone) are supplied
- Person not found in PDL database — returns empty result or 404 for individuals with limited digital footprint
- min_likelihood threshold too high — returns no result if confidence score of best match is below specified threshold
- Rate limiting or auth failure — returns 401/429 if payment or credentials are invalid
- Malformed phone number — returns validation error if phone does not include country code prefix

## How this service works

PDL Person Enrich - Enrich a person record with demographics, work history, education, contact info, social profiles, and skills. Supports lookup by name, email, phone, LinkedIn, or PDL ID.

## Output

Returns an enriched person record including full name, demographics, current and past job experiences, education history, email addresses, phone numbers, social media profiles (LinkedIn, Twitter, etc.), skills, and a likelihood/confidence score (1-10) indicating match quality. Also returns the PDL persistent person ID for future lookups.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lid": {
   "type": "string",
   "description": "LinkedIn ID"
  },
  "name": {
   "type": "string",
   "description": "Full name (first + last)"
  },
  "email": {
   "type": "string",
   "description": "Email address"
  },
  "phone": {
   "type": "string",
   "description": "Phone number (must start with +country_code)"
  },
  "pdl_id": {
   "type": "string",
   "description": "PDL persistent person ID"
  },
  "region": {
   "type": "string",
   "description": "State or province"
  },
  "school": {
   "type": "string",
   "description": "School name, website, or social URL"
  },
  "company": {
   "type": "string",
   "description": "Company name, website, or social URL"
  },
  "country": {
   "type": "string",
   "description": "Country"
  },
  "profile": {
   "type": "string",
   "description": "Social profile URL"
  },
  "locality": {
   "type": "string",
   "description": "City"
  },
  "location": {
   "type": "string",
   "description": "Residence location (street address to country)"
  },
  "required": {
   "type": "string",
   "description": "Boolean expression of required fields in the response"
  },
  "last_name": {
   "type": "string",
   "description": "Last name"
  },
  "titlecase": {
   "type": "boolean",
   "description": "Titlecase text in response"
  },
  "birth_date": {
   "type": "string",
   "description": "Birth date (YYYY or YYYY-MM-DD)"
  },
  "email_hash": {
   "type": "string",
   "description": "SHA-256 or MD5 email hash"
  },
  "first_name": {
   "type": "string",
   "description": "First name"
  },
  "middle_name": {
   "type": "string",
   "description": "Middle name"
  },
  "postal_code": {
   "type": "string",
   "description": "ZIP or postal code"
  },
  "data_include": {
   "type": "string",
   "description": "Comma-separated fields to include; prefix - to exclude"
  },
  "min_likelihood": {
   "type": "integer",
   "maximum": 10,
   "minimum": 1,
   "description": "Minimum confidence score (1-10, default 2)"
  },
  "street_address": {
   "type": "string",
   "description": "Street address"
  },
  "include_if_matched": {
   "type": "boolean",
   "description": "Include list of matched query inputs"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pdl-person-enrich-2d6992ae/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stable-people-data-git-shafu-pdl-api-settl-95fdf9-merit-systems.vercel.app](https://www.zero.xyz/host/stable-people-data-git-shafu-pdl-api-settl-95fdf9-merit-systems.vercel.app/llms.txt)