# 411data.io Person Search & Enrichment

> 411data.io Person Search & Enrichment is a paid API for AI agents from 411data.io, paid per call via x402, $0.5/call, status unknown (last checked 2026-09-15).

Finds phones (including mobile), emails, and addresses for a person by name, phone number, or address — billed only on a successful match.

## Facts

- Endpoint: POST https://411data.io/api/v1/enrich/person
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/411data-io-person-search-enrichment-67c1f2c4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9ITF9E2HiyXVXqCpCWF0Z

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 411data-io-person-search-enrichment-67c1f2c4 -d '<json body>'
```

Example prompt: Can you find the phone number, email, and address for Jane Doe who lives in Austin, Texas? I need her mobile if possible.

## When to prefer this

Choose this endpoint when you need direct contact data (phone, email, address) for a specific individual and want to pay only on a successful match. It is ideal for B2C lead enrichment, skip tracing, or verifying contact details for a known person. Prefer it over general web-research endpoints when structured directory data is sufficient and speed matters. Use the reverse phone sibling endpoint if you already have the phone number and need to identify the owner.

## Known failure modes

- No match found — person not in directory, no charge incurred
- Ambiguous name with no state/city qualifier returns multiple or zero results
- Phone number not recognized or not in reverse-lookup database
- Invalid or malformed input (missing name fields or invalid phone format)
- Rate limiting or API authentication failure

## How this service works

Person search: find phones (including mobile), emails, and addresses for a person by name, phone reverse lookup, or address. Bill-on-match.

## Output

Returns a matched person record containing one or more phone numbers (including mobile), email addresses, and physical addresses tied to the queried individual or phone number. The response is only billed when a match is found. No result is returned (and no charge incurred) when no match exists.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "city": {
   "type": "string",
   "maxLength": 120
  },
  "name": {
   "type": "string",
   "maxLength": 200
  },
  "phone": {
   "type": "string",
   "maxLength": 40
  },
  "street": {
   "type": "string",
   "maxLength": 200
  },
  "zipcode": {
   "type": "string",
   "maxLength": 10
  },
  "last_name": {
   "type": "string",
   "maxLength": 80
  },
  "first_name": {
   "type": "string",
   "maxLength": 80
  },
  "state_code": {
   "type": "string",
   "maxLength": 2
  },
  "middle_name": {
   "type": "string",
   "maxLength": 80
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "people": [
    {
     "name": "John Smith",
     "emails": [
      {
       "score": 88,
       "address": "john@example.com"
      }
     ],
     "phones": [
      {
       "label": "mobile",
       "score": 92,
       "number": "(412) 555-0198"
      }
     ]
    }
   ],
   "metadata": {
    "query_mode": "name_location",
    "result_count": 1
   }
  },
  "input": {
   "name": "John Smith",
   "zipcode": "15213",
   "state_code": "PA"
  },
  "billed": true,
  "vendor": "stub",
  "matched": true,
  "endpoint": "enrich/person",
  "cache_hit": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/411data-io-person-search-enrichment-67c1f2c4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 411data.io](https://www.zero.xyz/host/411data.io/llms.txt)