# Whitepages Pro — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API |
> |---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> People search, reverse phone lookup, property ownership, and deed events powered by 4B+ data linkages.

**Category:** Data / Intelligence | **Website:** [pro.whitepages.com](https://pro.whitepages.com) | **Docs:** [api.whitepages.com/docs](https://api.whitepages.com/docs)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/whitepages/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### Person Search

Search for individuals by name, phone, or address. Returns contact info, addresses, phones, emails, employment, relatives, and owned properties.

**Estimated cost:** $0.015

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | No | Full or partial name (e.g. "John Smith") |
| `first_name` | string | No | First name |
| `middle_name` | string | No | Middle name |
| `last_name` | string | No | Last name |
| `phone` | string | No | Phone number for reverse lookup (e.g. "2065550198") |
| `street` | string | No | Street address (e.g. "123 Main St") |
| `city` | string | No | City name |
| `state_code` | string | No | Two-letter state code (e.g. "NY") |
| `zipcode` | string | No | ZIP code |
| `min_age` | integer | No | Minimum age filter (18-65) |
| `max_age` | integer | No | Maximum age filter (18-65) |
| `include_historical_locations` | boolean | No | Include historical addresses in search (default: false) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/whitepages/person-search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"<string>","first_name":"<string>","middle_name":"<string>","last_name":"<string>","phone":"<string>","street":"<string>","city":"<string>","state_code":"<string>","zipcode":"<string>","min_age":"<integer>","max_age":"<integer>","include_historical_locations":"<boolean>"}'
```

### Person by ID

Retrieve detailed person information by Whitepages person ID.

**Estimated cost:** $0.015

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Whitepages person ID (e.g. "P1234567890") |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/whitepages/person-by-id \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"<string>"}'
```

### Property Search

Search for property by address. Returns ownership info, residents, geolocation, property details, tax data, and mortgage history.

**Estimated cost:** $0.015

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `street` | string | No | Street address (e.g. "1600 Pennsylvania Ave NW") |
| `city` | string | No | City name |
| `state_code` | string | No | Two-letter state code (e.g. "DC") |
| `zipcode` | string | No | ZIP code (e.g. "20500") |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/whitepages/property-search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"street":"<string>","city":"<string>","state_code":"<string>","zipcode":"<string>"}'
```

### Property by ID

Retrieve detailed property information by Whitepages property ID. Includes physical characteristics, tax assessments, ownership, mortgage history, and current residents.

**Estimated cost:** $0.015

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `property_id` | string | Yes | Whitepages property ID (e.g. "RVMKL8l80mK") |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/whitepages/property-by-id \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"property_id":"<string>"}'
```

### Search Deed Events

Search historical property deed events by region, date range, and property ID. Returns transfer details, parties, and property info.

**Estimated cost:** $0.015

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `region` | string | Yes | Geographic scope (e.g. "state:tx", "county:tx.travis", "county:48453") |
| `property_id` | string | No | Whitepages property ID to filter by |
| `event_date_from` | string | No | Start date inclusive (ISO 8601, e.g. "2026-01-01") |
| `event_date_to` | string | No | End date inclusive (ISO 8601, e.g. "2026-03-15") |
| `limit` | integer | No | Results per page (default 20, max 100) |
| `cursor` | string | No | Pagination cursor from previous response |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/whitepages/search-deed-events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"region":"<string>","property_id":"<string>","event_date_from":"<string>","event_date_to":"<string>","limit":"<integer>","cursor":"<string>"}'
```

### Get Event

Retrieve a single property deed event by its unique identifier. Returns full event details including property, parties, and transaction info.

**Estimated cost:** $0.015

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | Unique event identifier (e.g. "evt_abc123") |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/whitepages/get-event \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"<string>"}'
```

### List States

Retrieve a list of all US states and territories.

**Estimated cost:** $0.005

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/whitepages/list-states \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List Counties

Retrieve a list of counties for a given state.

**Estimated cost:** $0.005

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `state_code` | string | Yes | Two-letter state code (e.g. "TX") |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/whitepages/list-counties \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"state_code":"<string>"}'
```