{"uid":"cap_ooKJSmehlClkbQPQ-P1Pr","slug":"stablepeopledata-dev-93943616","name":"PDL Person Enrich","description":"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.","url":"https://stablepeopledata.dev/api/pdl/person/enrich","method":"POST","headers":{},"bodySchema":{"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"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.28","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.28/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.28","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.28","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_the5f77PYF1iRdM_-KvPJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.28","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Enrich a person record with demographics, work history, education, contact info, social profiles, and skills using People Data Labs data.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"CRM contact enrichment at scale","prompt":"I have a list of sales leads with just names and work emails — can you run each one through PDL and fill in their current job title, employer, LinkedIn URL, and location so my CRM records are complete?"},{"title":"Resolve phone number to full profile","prompt":"I've got a phone number, +1-415-555-0192, and I need to figure out who this person is — can you look them up and get me their full name, current employer, job title, and any social profiles associated with that number?"},{"title":"Recruiting candidate background lookup","prompt":"I'm looking at a candidate whose LinkedIn profile is linkedin.com/in/michael-torres-eng — can you pull his full work history, education, skills, and contact details so I can prep for our recruiting call?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:34:00.170Z","isFirstParty":false}