# Whitepages Person Search

> Whitepages Person Search is a paid API for AI agents from StableEnrich at stableenrich.dev, paid per call via MPP or x402, $0.22/call, status unknown (last checked 2026-10-10, last successful call 2026-07-13).

Search for people by name, phone, or address and retrieve contact details, relatives, employment, and more via Whitepages data.

## Facts

- Endpoint: POST https://stableenrich.dev/api/whitepages/person-search?utm_source=zero.xyz
- Price: $0.22/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-10-10
- Last successful call: 2026-07-13
- Success rate: 89% of calls made through Zero
- Rating: 3.6 / 5 from 3 reviews
- Activations on Zero: 15
- Provider: StableEnrich
- Docs: https://stableenrich.dev
- Website: https://stableenrich.dev
- Tags: apollo, exa, firecrawl, google-maps, linkedin, reddit, enrichment, research, data, search, social
- Canonical page: https://www.zero.xyz/c/stableenrich-person-search-9aaa7a6f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dnJzjWRI_HyjQZEVNUdfH

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 stableenrich-person-search-9aaa7a6f -d '<json body>'
```

Example prompt: Can you look up John Smith in Seattle, WA on Whitepages — I'm trying to find his current address, phone number, and any known relatives? He's probably between 35 and 55 years old.

## When to prefer this

Use this endpoint when you need to find or verify a real person's contact details, address history, relatives, or employment information using Whitepages data. Prefer this over general web search when structured, aggregated people-data is needed, especially for US residents. Use over LinkedIn-based enrichment when the person may not have a LinkedIn profile or when address/phone data is the primary goal.

## Known failure modes

- No matching persons found — empty persons array returned
- Insufficient search parameters — requires at least name or phone or address
- Invalid state_code format — must be two-letter US state abbreviation
- Radius exceeds 100 miles — API enforces maximum radius constraint
- Timeout or upstream Whitepages service unavailability

## How this service works

Whitepages Person Search - Find people by name, phone, address

## Output

Returns an array of matching persons, each with name, emails, phone numbers (with type and score), aliases, date of birth, job title, company name, LinkedIn URL, relatives (with IDs and names), current and historical addresses, owned properties, and deceased status.

## Example request

```json
{
 "city": "Seattle",
 "max_age": 55,
 "min_age": 35,
 "last_name": "Smith",
 "first_name": "John",
 "state_code": "WA"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "city": {
   "type": "string",
   "description": "City name"
  },
  "name": {
   "type": "string",
   "description": "Full name to search for"
  },
  "phone": {
   "type": "string",
   "description": "Phone number"
  },
  "radius": {
   "type": "number",
   "maximum": 100,
   "description": "Radius in miles from address (max 100)"
  },
  "street": {
   "type": "string",
   "description": "Street address"
  },
  "max_age": {
   "type": "number",
   "description": "Maximum age filter"
  },
  "min_age": {
   "type": "number",
   "description": "Minimum age filter"
  },
  "zipcode": {
   "type": "string",
   "description": "ZIP code"
  },
  "last_name": {
   "type": "string",
   "description": "Last name"
  },
  "first_name": {
   "type": "string",
   "description": "First name"
  },
  "state_code": {
   "type": "string",
   "description": "Two-letter state code"
  },
  "excludeFields": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "include_historical_locations": {
   "type": "boolean",
   "description": "Include historical addresses in radius search"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "persons"
 ],
 "properties": {
  "persons": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "name": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "emails": {
      "anyOf": [
       {
        "type": "array",
        "items": {
         "type": "string"
        }
       },
       {
        "type": "null"
       }
      ]
     },
     "phones": {
      "anyOf": [
       {
        "type": "array",
        "items": {
         "type": "object",
         "properties": {
          "type": {
           "anyOf": [
            {
             "type": "string"
            },
            {
             "type": "null"
            }
           ]
          },
          "score": {
           "anyOf": [
            {
             "type": "number"
            },
            {
             "type": "null"
            }
           ]
          },
          "number": {
           "anyOf": [
            {
             "type": "string"
            },
            {
             "type": "null"
            }
           ]
          }
         },
         "additionalProperties": {}
        }
       },
       {
        "type": "null"
       }
      ]
     },
     "aliases": {
      "anyOf": [
       {
        "type": "array",
        "items": {
         "type": "string"
        }
       },
       {
        "type": "null"
       }
      ]
     },
     "is_dead": {
      "anyOf": [
       {
        "type": "boolean"
       },
       {
        "type": "null"
       }
      ]
     },
     "job_title": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "relatives": {
      "anyOf": [
       {
        "type": "array",
        "items": {
         "type": "object",
         "properties": {
          "id": {
           "anyOf": [
            {
             "type": "string"
            },
            {
             "type": "null"
            }
           ]
          },
          "name": {
           "anyOf": [
            {
             "type": "string"
            },
            {
             "type": "null"
            }
           ]
          }
         },
         "additionalProperties": {}
        }
       },
       {
        "type": "null"

… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stableenrich-person-search-9aaa7a6f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stableenrich.dev](https://www.zero.xyz/host/stableenrich.dev/llms.txt)