New: pagination on person search, fuzzy matching, and more. See what's changed →
Whitepages
Agentic Guidance

Capability Map

Map a user's intent to the exact endpoint and parameters that answer it.

Start here. This table maps what you are trying to do to the endpoint and parameters that do it. Match the intent, copy the parameters, then read the type document for that endpoint before writing your types.

Person search is one endpoint. Reverse phone lookup, address lookup, and name search are all the same GET /v2/person/ call with different parameters. There is no separate "phone lookup" endpoint — pass phone= to person search.

People

You want to…EndpointKey parameters
Reverse phone lookup (who owns a number)GET /v2/person/phone=
Find who lives at an addressGET /v2/person/street, city, state_code, zipcode
Find a person by nameGET /v2/person/name, or first_name / middle_name / last_name (+ location)
Narrow a person searchGET /v2/person/min_age / max_age, include_fuzzy_matching, include_historical_locations, radius
Page through person resultsGET /v2/person/page, page_size
Get full detail for a known personGET /v2/person/{id}path id (the id from any person object)

A person search returns results scored by match_score (1–99). See Entity Shapes for how a person's shape differs by context.

Property

You want to…EndpointKey parameters
Find who owns a propertyGET /v2/property/street, city, state_code, zipcode → read ownership_info
Find current residents of a propertyGET /v2/property/same address params → read residents
Get property detail by idGET /v2/property/{id}path id (R-prefixed property id or A-prefixed address id)

Owners and residents come back as summary person objects that carry an id. To get full detail (date of birth, relatives, historic addresses), call GET /v2/person/{id} with that id — see Entity Shapes.

Events and account

You want to…EndpointKey parameters
Find deed events / property transactionsGET /v1/events/deedsee Events reference
Check usage / remaining quotaGET /v1/account/usage/date range

What's next

  • Integration Guide — the workflow to follow before writing integration code.
  • Entity Shapes — the shapes you get back and how to hydrate summaries.
  • FAQ — trial limits, rate limits, and breaking changes.

On this page