{"uid":"cap_EDb-4Ph6ifKaIZvIGcAFC","slug":"minerva-identity-resolution-enrichment-api-536c3431","name":"Minerva Identity Resolution & 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/resolve","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"},"name_suffix":{"type":"string","description":"Name suffix (e.g., \"Jr.\", \"Sr.\", \"III\")"}},"additionalProperties":false},"minItems":1,"description":"Array of person records to resolve. Maximum 1000 per request."},"match_condition_fields":{"type":"array","items":{"type":"string"},"description":"Fields that must be present for a match to be returned. Valid options: \"minerva_pid\", \"linkedin_url\""}}},"responseSchema":{"type":"json","example":{}},"example":{"request":{"records":[{"emails":["jane.doe@example.com"],"last_name":"Doe","record_id":"test-001","first_name":"Jane"}]},"response":{"results":[{"is_match":false,"record_id":"test-001","match_score":null,"minerva_pid":null,"linkedin_url":null,"validation_errors":{},"is_resolvable_record":true}],"api_request_id":"2508efda-0904-4af5-87ac-f7e43da1f3b6","request_completed_at":"2026-06-18T06:08:20.827347+00:00"}},"exampleRequest":{"records":[{"emails":["jane.doe@example.com"],"last_name":"Doe","record_id":"test-001","first_name":"Jane"}]},"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yE60HDX6ZkOMc5pzgNXF9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves, enriches, and validates consumer identity data including email validation and person search using AI-powered behavioral understanding","exampleAgentPrompt":"Can you resolve and enrich the identity for someone named Jane Doe with email jane.doe@example.com — I want to know if the email is valid and get whatever consumer profile data Minerva can return about her?","exampleUseCases":null,"resultDescription":"A JSON object containing the resolved identity record, enriched person profile attributes, email validation status, and AI-derived consumer behavior insights for the queried individual","failureModes":["Invalid or unrecognized identity inputs return empty or null resolution results","Email address not found in Minerva's database returns no enrichment data","Malformed request body returns a 400-level error","Insufficient USDC balance or failed x402 payment results in a 402 Payment Required response","Rate limiting or quota exceeded returns a 429 error","Ambiguous identity inputs may return low-confidence or multiple candidate matches"],"whenToPreferThis":"Choose this endpoint when you need to resolve, enrich, or validate a consumer identity using AI-powered behavioral understanding — particularly when you have partial information like a name or email and want a full profile. Prefer over generic email validators when you also need person enrichment, and over simple people-search APIs when you want AI that models consumer behavior patterns.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:39:09.560Z","isFirstParty":false}