{"uid":"cap_JdTHHh23Ron0eodAtHW9c","slug":"minerva-identity-enrichment-api-b2105cdc","name":"Minerva Identity Enrichment API","description":"Pay-per-request access to Minerva identity resolution, enrichment, email validation, and person search. AI that understands consumer behavior.","url":"https://agentcash.minerva.io/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. 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. Valid options: \"linkedin_url\", \"gender\", \"estimated_income_range\", \"estimated_wealth_range\", \"email\", \"personal_email\", \"professional_email\", \"phone\", \"mobile_phone\""}}},"responseSchema":{"type":"json","example":{}},"example":{"request":{"records":[{"emails":["john.smith@example.com"],"last_name":"Smith","record_id":"test-001","first_name":"John"}]},"response":{"results":[{"age":null,"dob":null,"gender":null,"phones":[],"is_match":false,"full_name":null,"last_name":null,"record_id":"test-001","first_name":null,"is_retired":null,"match_score":null,"middle_name":null,"minerva_pid":null,"name_suffix":null,"twitter_url":null,"facebook_url":null,"linkedin_url":null,"linkedin_title":null,"personal_emails":[],"work_experience":[],"linkedin_industry":null,"validation_errors":null,"professional_emails":[],"education_experience":[],"minerva_household_id":null,"estimated_income_range":null,"estimated_wealth_range":null,"is_likely_remote_worker":null,"linkedin_profile_pic_url":null}],"api_request_id":"ce925818-b5d8-47b8-a063-e600c2b0c7d2","request_completed_at":"2026-06-18T05:52:15.972366+00:00"}},"exampleRequest":{"records":[{"emails":["john.smith@example.com"],"last_name":"Smith","record_id":"test-001","first_name":"John"}]},"tags":["x402"],"displayCostAmount":"0.05","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.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_sSUNTTZsZJtPPLq5KueQ5","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 a person's profile with identity resolution, behavioral data, email validation, and person search using AI-driven consumer intelligence","exampleAgentPrompt":"Look up and enrich the profile for john.smith@example.com using Minerva — I need their identity resolved, email validated, and any consumer behavior data you can find on them.","exampleUseCases":[{"title":"Qualify inbound leads before outreach","prompt":"I've got a list of leads from our last webinar signup form — can you run each email through Minerva and pull back their identity info, validate the emails, and flag any consumer behavior signals that would help us prioritize who to call first?"},{"title":"Enrich CRM contacts with behavioral data","prompt":"We have a bunch of contacts in our CRM that only have a name and email address. Can you use Minerva to fill in the gaps — validate their emails, resolve their identities, and add any behavioral or demographic data Minerva has on them?"},{"title":"Flag suspicious signups for fraud review","prompt":"We've got a batch of new account signups that look a little off. Can you run their emails through Minerva to validate them, resolve who these people actually are, and surface any behavioral signals that might indicate fraudulent intent?"}],"resultDescription":"A JSON object containing enriched person profile data including identity resolution results, validated email status, consumer behavior signals, demographic attributes, and any additional contact or profile details Minerva can associate with the queried identity.","failureModes":["Invalid or malformed email input returns validation error","Person not found in Minerva database returns empty or null profile","Insufficient identity signals to resolve returns low-confidence result","Payment failure via x402 protocol blocks request","Rate limiting or quota exceeded returns 429 error","Network timeout for slow enrichment lookups"],"whenToPreferThis":"Choose this endpoint when you need AI-powered identity resolution and person enrichment that goes beyond basic demographic lookup — particularly when you want consumer behavior signals alongside standard contact enrichment. Best for sales intelligence, lead qualification, or fraud prevention use cases where understanding consumer behavior patterns matters. Prefer over generic enrichment APIs when paying per-request economics make sense and you need Minerva's specific consumer intelligence layer.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:33:23.520Z","isFirstParty":false}