# Minerva Identity Enrichment API

> Minerva Identity Enrichment API is a paid API for AI agents from agentcash.minerva.io, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Enriches a person's profile with identity resolution, behavioral data, email validation, and person search using AI-driven consumer intelligence

## Facts

- Endpoint: POST https://agentcash.minerva.io/api/minerva/enrich
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/minerva-identity-enrichment-api-b2105cdc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JdTHHh23Ron0eodAtHW9c

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability minerva-identity-enrichment-api-b2105cdc -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Pay-per-request access to Minerva identity resolution, enrichment, email validation, and person search. AI that understands consumer behavior.

## Output

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.

## Example request

```json
{
 "records": [
  {
   "emails": [
    "john.smith@example.com"
   ],
   "last_name": "Smith",
   "record_id": "test-001",
   "first_name": "John"
  }
 ]
}
```

## Request schema (JSON Schema)

```json
{
 "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\""
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/minerva-identity-enrichment-api-b2105cdc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentcash.minerva.io](https://www.zero.xyz/host/agentcash.minerva.io/llms.txt)