{"uid":"cap_MvIuI7pIJu6AaLtdS35bq","slug":"minerva-enrich-person-record-enrichment-5b7e865f","name":"Minerva Enrich - Person Record Enrichment","description":"Pay-per-request access to FullEnrich, CompanyEnrich, LeadMagic, Clado, Exa, Firecrawl, Google Maps, Serper, and Whitepages APIs. No auth, no subscriptions.","url":"https://stableenrich.dev/api/minerva/enrich","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"records":{"type":"array","items":{"type":"object","properties":{"emails":{"type":"array","items":{"type":"string"},"description":"Array of email addresses"},"phones":{"type":"array","items":{"type":"string"},"description":"Array of phone numbers"},"full_name":{"type":"string","description":"Person's full name"},"last_name":{"type":"string","description":"Person's last name"},"record_id":{"type":"string","description":"Your unique identifier for this record"},"first_name":{"type":"string","description":"Person's first name"},"middle_name":{"type":"string","description":"Person's middle name"},"minerva_pid":{"type":"string","description":"Direct Minerva Person ID lookup for instant enrichment"},"name_suffix":{"type":"string","description":"Name suffix (e.g., \"Jr.\", \"Sr.\", \"III\")"},"linkedin_url":{"type":"string","description":"LinkedIn profile URL for direct enrichment"}},"additionalProperties":false},"minItems":1,"description":"Array of person records to enrich. Maximum 500 per request."},"return_fields":{"type":"array","items":{"type":"string"},"description":"Fields to return beyond base fields. Alias: \"education\" → \"education_experience\". Omit to return all fields. Example: [\"full_name\", \"personal_emails\", \"phones\", \"work_experience\"]."},"match_condition_fields":{"type":"array","items":{"type":"string"},"description":"Fields that must be present for a match to be returned. Alias: \"email\" → \"emails\". Valid options include \"emails\", \"linkedin_url\", \"gender\", \"estimated_income_range\", \"estimated_wealth_range\", \"personal_email\", \"professional_email\", \"phone\", \"mobile_phone\", \"home_ownership_status\"."}}},"responseSchema":null,"example":{"request":{"records":[{"emails":["john.smith@example.com"],"full_name":"John Smith","record_id":"test_001"}],"return_fields":["full_name","personal_emails","phones","work_experience"]},"response":{"results":[{"phones":[],"is_match":false,"full_name":null,"record_id":"test_001","match_score":null,"minerva_pid":null,"personal_emails":[],"work_experience":[],"validation_errors":null}],"api_request_id":"07ef9ba5-c258-4654-85fc-da113e3f9122","request_completed_at":"2026-06-12T04:30:14.676065+00:00"}},"exampleRequest":{"records":[{"emails":["john.smith@example.com"],"full_name":"John Smith","record_id":"test_001"}],"return_fields":["full_name","personal_emails","phones","work_experience"]},"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":2,"rating":{"score":"0.50","successRate":"0.60","reviews":2,"stars":"3.0","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Fo1VeUau6-AXTx0GWemml","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Enriches person records with demographics, work history, contact info, and wealth/income data using name, email, phone, or LinkedIn URL as input identifiers","exampleAgentPrompt":"Enrich this person record using Minerva — I have their name 'Jane Smith', email 'jane.smith@example.com', and LinkedIn 'https://linkedin.com/in/janesmith' — and return their phone numbers, estimated income range, work experience, and personal emails.","exampleUseCases":null,"resultDescription":"An array of matched person records, each containing a match score, Minerva person ID, full demographics (age, gender, DOB, marital status), contact info (phones ranked by type, personal and professional emails), work experience, LinkedIn/Twitter/Facebook URLs, estimated income and wealth ranges, home ownership status, retirement status, and relatives — alongside request metadata like api_request_id and completion timestamp.","failureModes":["No match found: is_match returns false when the provided identifiers don't resolve to a known person","Low match score: ambiguous inputs like a common name without email/phone may return low-confidence matches","Validation error: records array is empty or exceeds 500 items","Invalid match_condition_fields: using field names not in the allowed enum list causes a 400 error","Rate or payment failure: insufficient USDC balance or x402 payment issue causes request rejection","Partial enrichment: some requested return_fields may be null if data is unavailable for that person"],"whenToPreferThis":"Use this endpoint when you need to append rich demographic, financial, and contact data to person records you already have partial identifiers for (name, email, phone, LinkedIn). Prefer it over a people search endpoint when you have existing records to match and enrich rather than needing to discover new prospects. Best for CRM enrichment, identity resolution, and building detailed person profiles at scale (up to 500 records per call).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":5,"lastUsedAt":"2026-07-17T21:00:09.409Z","lastSuccessfullyRanAt":"2026-07-17T21:00:09.409Z","lastHealthCheckAt":"2026-09-15T06:49:32.841Z","isFirstParty":false}