{"uid":"cap_79VutDS19zmPcouPZCoIy","slug":"pdl-person-enrichment-api-c49125df","name":"PDL Person Enrichment API","description":"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.","url":"https://stable-enrich-git-shafu-pdl-not-found-200-merit-systems.vercel.app/api/pdl/people-enrich","method":"POST","headers":{},"bodySchema":{"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}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.2","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Oo6UR6Df7PDD1BIb-j_p9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.2","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Enriches a person record with full career history, email addresses, and phone numbers using People Data Labs (PDL) data.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Sales lead enrichment before outreach","prompt":"I have a lead named James Holloway who I think works at Salesforce — can you enrich his profile using his email james.holloway@salesforce.com and get me his current job title, career history, and any phone numbers on file?"},{"title":"Recruiting candidate background lookup","prompt":"I'm considering reaching out to a candidate named Priya Nair — her LinkedIn is linkedin.com/in/priyanair — can you pull her full work history, education, and any contact details you can find?"},{"title":"CRM contact data completion","prompt":"We have a contact in our CRM — Michael Torres, last known email mitorres@acme.com — can you fill in his current employer, job title, full career history, and any additional email addresses or phone numbers?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:33:40.101Z","isFirstParty":false}