{"uid":"cap_vIlvizVXtEmddmIXoNKdK","slug":"pdl-person-enrich-2d6992ae","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://stable-people-data-git-shafu-pdl-api-settl-95fdf9-merit-systems.vercel.app/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":"probe","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_7UtXN8larkboVWRaRlRtY","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.","exampleAgentPrompt":"Can you enrich this lead for me — her name is Sarah Chen, email is sarah.chen@acmecorp.com, and she works at Acme Corp? I want her full work history, education, social profiles, and skills, and only return results with a confidence score of at least 6.","exampleUseCases":[{"title":"CRM lead enrichment before outreach","prompt":"I have a new sales lead — John Martinez, email j.martinez@techstartup.io. Can you pull his full professional profile including job history, education, and any social profiles so I can personalize my outreach?"},{"title":"Recruiting candidate background lookup","prompt":"We're considering a candidate named Priya Patel who lists her LinkedIn as linkedin.com/in/priya-patel-eng — can you enrich her record to get her full work history, skills, and education before the interview?"},{"title":"Contact data append for marketing list","prompt":"I have a phone number +14155550192 for a contact named David Lee — can you look him up and fill in his current job title, employer, location, and any email addresses associated with him?"}],"resultDescription":"Returns an enriched person record including full name, demographics, current and past job experiences, education history, email addresses, phone numbers, social media profiles (LinkedIn, Twitter, etc.), skills, and a likelihood/confidence score (1-10) indicating match quality. Also returns the PDL persistent person ID for future lookups.","failureModes":["Insufficient identifiers provided — returns 404 or low-likelihood match if only weak signals (e.g. name alone) are supplied","Person not found in PDL database — returns empty result or 404 for individuals with limited digital footprint","min_likelihood threshold too high — returns no result if confidence score of best match is below specified threshold","Rate limiting or auth failure — returns 401/429 if payment or credentials are invalid","Malformed phone number — returns validation error if phone does not include country code prefix"],"whenToPreferThis":"Use this endpoint when you need to enrich a known individual's record starting from a partial identifier (email, phone, LinkedIn URL, name+company) and want comprehensive professional profile data including work history, education, skills, and contact info. Prefer this over person search when you already have a specific individual in mind rather than running a broad query across the database. Best for CRM enrichment, sales lead qualification, recruiting research, and identity resolution use cases where People Data Labs' 3B+ person database coverage is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:33:53.969Z","isFirstParty":false}