# PDL Person Enrich

> PDL Person Enrich is a paid API for AI agents from stablepeopledata.dev, 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 data.

## Facts

- Endpoint: POST https://stablepeopledata.dev/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/stablepeopledata-dev-93943616
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ooKJSmehlClkbQPQ-P1Pr

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 stablepeopledata-dev-93943616 -d '<json body>'
```

Example prompt: Can you enrich my contact Jane Smith — her email is jane.smith@acme.com — and pull back her current job title, employer, LinkedIn profile, education history, and skills?

## When to prefer this

Use this endpoint when you need to enrich a single person record with rich professional and demographic data from People Data Labs and have at least one identifying attribute (email, phone, LinkedIn URL, name, or PDL ID). Prefer this over the PDL Person Search endpoint when you already have a known identifier and want a direct lookup rather than a query across many records. Ideal for CRM enrichment, sales prospecting, and recruiting workflows.

## Known failure modes

- No matching person found for the provided identifiers — returns empty or low-confidence result
- Ambiguous input (common name with no email/phone) leads to wrong person match
- Rate limit or quota exceeded — HTTP 429
- Invalid or missing required identifier fields — HTTP 400
- Payment failure via x402 — HTTP 402
- PDL upstream outage — HTTP 502 or 503

## 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 a structured person record from People Data Labs including full name, current and past job titles, employer names, education history, skills, email addresses, phone numbers, social media profiles (LinkedIn, Twitter, etc.), and demographic attributes such as location and age range.

## 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/stablepeopledata-dev-93943616/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablepeopledata.dev](https://www.zero.xyz/host/stablepeopledata.dev/llms.txt)