# PDL People Enrichment API

> PDL People Enrichment API is a paid API for AI agents from stable-enrich-git-shafu-pdl-people-enrich-4ce5a8-merit-systems.vercel.app, paid per call via x402, $0.2/call, status unknown (last checked 2026-09-15).

Enriches a person's profile with full career history, email addresses, and phone numbers using People Data Labs (PDL) data.

## Facts

- Endpoint: POST https://stable-enrich-git-shafu-pdl-people-enrich-4ce5a8-merit-systems.vercel.app/api/pdl/people-enrich
- Price: $0.2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pdl-people-enrichment-api-ac8b75d5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1UiUKKB5c4Rr1UuzS7EaT

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-people-enrichment-api-ac8b75d5 -d '<json body>'
```

Example prompt: Look up the full career history, email addresses, and phone numbers for jane.doe@example.com using People Data Labs — I need her current employer, job title, and any other contact details on file.

## When to prefer this

Use this endpoint when you need comprehensive professional profile enrichment — career history, emails, and phone — backed by PDL's large dataset. Prefer providing an email address as the lookup key for highest match reliability. Best for B2B sales lead enrichment, recruiting background checks, and CRM data augmentation where PDL coverage is acceptable. Note the $0.20/request cost and that 404s are definitive — the person is not in PDL.

## Known failure modes

- HTTP 404: person not found in PDL — switching lookup format (e.g. name vs email) will not help
- Stale data: is_primary flags on board/advisory roles may reflect outdated affiliations
- Incomplete records: not all fields populated for every person
- PII exposure: responses include personal contact information requiring careful handling
- Rate limiting or payment failure: $0.20 USDC required per call via x402 protocol

## How this service works

PDL Person Enrich — full career history, emails, and phone. Prefer email when known (highest reliability). $0.20/request. HTTP 404 = person not in PDL (switching lookup format will not help). is_primary may reflect stale board/advisory roles. Responses may include personal PII.

## Output

Returns a structured person profile including full career history (employers, titles, date ranges), known email addresses with primary flags, phone numbers, education history, social profile URLs, and demographic data sourced from PDL's database. HTTP 404 indicates the person is not in PDL's dataset.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "properties": {
      "email": {
       "type": "string",
       "description": "Email address — highest-reliability input; prefer over profile/name when known."
      },
      "profile": {
       "type": "string",
       "description": "LinkedIn or other social profile URL. Similar coverage to name+domain — not a fallback when person is absent (404)."
      },
      "last_name": {
       "type": "string",
       "description": "Last name."
      },
      "first_name": {
       "type": "string",
       "description": "First name."
      },
      "company_name": {
       "type": "string",
       "description": "Company name (with first_name + last_name). Fallback; similar coverage to profile."
      },
      "company_domain": {
       "type": "string",
       "description": "Company domain (with first_name + last_name). Fallback; similar coverage to profile."
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pdl-people-enrichment-api-ac8b75d5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stable-enrich-git-shafu-pdl-people-enrich-4ce5a8-merit-systems.vercel.app](https://www.zero.xyz/host/stable-enrich-git-shafu-pdl-people-enrich-4ce5a8-merit-systems.vercel.app/llms.txt)