# PDL Person Enrichment API

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

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

## Facts

- Endpoint: POST https://stable-enrich-git-shafu-pdl-not-found-200-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-person-enrichment-api-c49125df
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_79VutDS19zmPcouPZCoIy

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

Example prompt: Can you look up everything you can find on Sarah Chen — she works at Stripe, her email is sarah.chen@stripe.com — I need her full career history, any other emails on file, and a phone number if available.

## When to prefer this

Prefer this endpoint when you need comprehensive person enrichment including career history, multiple email addresses, and phone numbers — especially when you already have an email address as the lookup key (highest reliability). Best suited for sales intelligence, recruiting pipelines, and CRM enrichment workflows where deep professional background data from PDL's dataset is required. Note that no-match responses are HTTP 200 with a status field of 404, so agent logic must inspect the response body rather than relying solely on HTTP status codes.

## Known failure modes

- No match found: HTTP 200 with status=404 and data=null — must check status field, not HTTP code
- Stale role data: is_primary may incorrectly flag advisory or board roles as primary employment
- Insufficient identifying information: query with too few fields may return no match or wrong person
- PII exposure: responses may include sensitive personal information requiring careful handling
- Rate or cost limits: each call costs $0.20 USDC; budget exhaustion will halt enrichment workflows

## How this service works

PDL Person Enrich — full career history, emails, and phone. Prefer email when known (highest reliability). $0.20/request. No match returns HTTP 200 with status 404 and data null — not an HTTP error. is_primary may reflect stale board/advisory roles. Responses may include personal PII.

## Output

Returns a JSON object containing the matched person's full career history (employers, titles, dates), known email addresses, phone numbers, education, social profile URLs, and other PII. A successful match returns HTTP 200 with populated data. No match returns HTTP 200 with a status field of 404 and data set to null — not an HTTP-level error. The is_primary flag on roles may reflect stale board or advisory positions.

## 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 (data: null)."
      },
      "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-person-enrichment-api-c49125df/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stable-enrich-git-shafu-pdl-not-found-200-merit-systems.vercel.app](https://www.zero.xyz/host/stable-enrich-git-shafu-pdl-not-found-200-merit-systems.vercel.app/llms.txt)