# PDL Person Enrichment API

> PDL Person Enrichment API is a paid API for AI agents from stable-enrich-git-shafu-stabledomains-pork-25b57c-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 career history, emails, and phone numbers using People Data Labs (PDL) data, identified by email, LinkedIn URL, or name+company.

## Facts

- Endpoint: POST https://stable-enrich-git-shafu-stabledomains-pork-25b57c-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-b35d1922
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_i-AcrapNj1cwda2II5OML

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-b35d1922 -d '<json body>'
```

Example prompt: Can you pull up the career history, email addresses, and phone numbers for Jane Smith who works at Stripe? Her LinkedIn is linkedin.com/in/janesmith.

## When to prefer this

Use this endpoint when you have a specific individual to look up and need comprehensive contact and career data — especially when you have their email (most reliable), LinkedIn profile URL, or at minimum their full name plus company name or domain. Prefer over general people-search endpoints when you know who you're looking for rather than searching by criteria. Best for lead enrichment, candidate research, or contact verification workflows where PII is acceptable.

## Known failure modes

- Insufficient identifiers (first+last name alone without company) returns HTTP 400
- No matching person found returns HTTP 200 with status=404 and data=null
- Invalid LinkedIn URL format causes lookup failure
- Rate limiting or quota exceeded returns an error response
- Stale or incomplete PDL data may return partial profile with missing fields

## How this service works

PDL Person Enrich — career history, emails, phone. Requires one of: `email`, `profile` (LinkedIn URL), or `first_name` + `last_name` + (`company_name` OR `company_domain`). `{ first_name, last_name }` alone returns 400. Prefer `email` when known, then `profile`. No match: HTTP 200, status 404, data null. May include personal PII.

## Output

Returns a structured person profile including full name, current and past job titles, employers, career timeline, known email addresses, phone numbers, location, and social profiles. If no match is found, returns HTTP 200 with status 404 and data as null. May include personal PII.

## 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-b35d1922/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stable-enrich-git-shafu-stabledomains-pork-25b57c-merit-systems.vercel.app](https://www.zero.xyz/host/stable-enrich-git-shafu-stabledomains-pork-25b57c-merit-systems.vercel.app/llms.txt)