# Minerva Person Search API

> Minerva Person Search API is a paid API for AI agents from agentcash.minerva.io, paid per call via x402, $0.04/call, status unknown (last checked 2026-09-15).

Search for a person by name, email, or other identifiers and receive enriched identity profile data including contact info and consumer behavior insights

## Facts

- Endpoint: POST https://agentcash.minerva.io/api/minerva/person-search
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/minerva-person-search-api-a6857a04
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hkOFYVv2CRFnXw7tyoOSQ

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-person-search-api-a6857a04 -d '<json body>'
```

Example prompt: Can you search Minerva for a person named John Martinez in Austin, TX — I need their email, phone, and any consumer behavior profile you can find on them?

## When to prefer this

Choose this endpoint when you need to resolve or enrich a person's identity using partial information such as a name or email, especially when consumer behavior context is valuable. Prefer this over generic people-search APIs when you need Minerva's AI-driven consumer intelligence layer alongside standard contact data.

## Known failure modes

- Person not found — no matching record in Minerva's database returns empty or null result
- Insufficient identifying information provided — query too vague to resolve a unique individual
- Invalid or malformed email input causes validation failure
- Payment failure via x402 protocol blocks the request before processing
- Rate limiting or quota exceeded returns an error response
- Ambiguous query matches multiple persons with no clear top result

## How this service works

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

## Output

Returns a JSON object containing an enriched person profile, which may include name, email address, phone number, location, identity resolution confidence, and consumer behavior insights derived from Minerva's AI models.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "size": {
   "type": "integer",
   "default": 100,
   "maximum": 100,
   "minimum": 1,
   "description": "Maximum number of person identifiers to return"
  },
  "query": {
   "type": "string",
   "maxLength": 500,
   "minLength": 1,
   "description": "Natural-language description of the people you want to find"
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/minerva-person-search-api-a6857a04/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)