# 411data.io Reverse Phone Lookup

> 411data.io Reverse Phone Lookup is a paid API for AI agents from 411data.io, paid per call via x402, $0.33/call, status unknown (last checked 2026-09-13).

Given a phone number, returns the associated person's name, email addresses, and physical addresses — billed only on a match.

## Facts

- Endpoint: POST https://411data.io/api/v1/enrich/phone
- Price: $0.33/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/411data-io-reverse-phone-lookup-a5a25c5b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EwrSeHpGTTxc55q0Px5zL

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-reverse-phone-lookup-a5a25c5b -d '<json body>'
```

Example prompt: Can you do a reverse phone lookup on +1-415-555-0192 and tell me the person's name, any email addresses, and their current address?

## When to prefer this

Use this endpoint when you have a phone number and need to identify the person behind it — their name, email, or address — without paying unless a match is returned. Preferred over person-search endpoints when the phone number is your primary identifier. Best for lead enrichment, unknown-caller identification, or contact verification workflows where cost efficiency (bill-on-match) matters.

## Known failure modes

- No match found for the number — no charge applied but empty result returned
- Invalid or malformed phone number format — request rejected with validation error
- Number is unlistable (VOIP, burner, or newly issued) — low or no match rate
- Rate limiting or quota exceeded — 429 error
- Service unavailable — 5xx error

## How this service works

Reverse phone lookup (bill-on-match). Returns person name, emails, and addresses tied to the number.

## Output

Returns the matched person's full name, one or more associated email addresses, and one or more physical/mailing addresses linked to the phone number. Response is billed at $0.33 USDC only when a match is found (bill-on-match model).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "phone": {
   "type": "string",
   "maxLength": 40,
   "minLength": 5
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "people": [
    {
     "name": "James W Cole Sr",
     "wp_id": "PX3vrMbpE3k",
     "emails": [],
     "phones": [
      {
       "type": "unknown",
       "label": "unknown",
       "score": 71,
       "number": "(724) 206-0094",
       "source": "https://411data.io/person-hunt",
       "sources": [
        {
         "url": "https://411data.io/person-hunt",
         "label": "person hunt",
         "wp_id": "PX3vrMbpE3k",
         "vendor": "whitepages"
        }
       ]
      }
     ],
     "source": "https://411data.io/person-hunt",
     "aliases": [
      "James Cole Jr",
      "Jim W Cole"
     ],
     "addresses": [],
     "job_title": null,
     "relatives": [],
     "company_name": null,
     "linkedin_url": null
    }
   ],
   "metadata": {
    "page": 1,
    "page_size": 5,
    "query_mode": "reverse_phone",
    "result_count": 5
   }
  },
  "input": {
   "phone": "+17242060094"
  },
  "billed": true,
  "vendor": "whitepages",
  "matched": true,
  "endpoint": "enrich/phone",
  "cache_hit": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/411data-io-reverse-phone-lookup-a5a25c5b/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)