Search for a person by name, phone number, and address
Changed onRetrieve person information based on the provided query parameters.
This endpoint accepts a person query request and returns full details for up to the top 15 matching persons from Whitepages data.
Request
- Base URLhttps://api.whitepages.com
- AuthAPI key in header x-api-key
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
Phone number to search for a person by
Full name, first name, last name, or partial name match for the person
First name of the person. Cannot be used with 'name' parameter.
Middle name of the person. Cannot be used with 'name' parameter.
Last name of the person. Cannot be used with 'name' parameter.
Full or partial street address including street number, name
Full city name
Valid US State and Territory codes.
This enum contains all valid two-letter codes for US states and territories. Used for parameter validation in API requests.
2-Letter code representing a state name
Full 5-digit ZIP code
Include historical addresses in search. When false (default), only current addresses are included.
Minimum age of the person to search for, must be between 18 and 65
Maximum age of the person to search for, must be between 18 and 65
Search radius in miles for distance-based filtering
Suppress automatic broadening. When true, the search does not fall back to fuzzy matching or radius expansion on a zero-result response; the exact query is authoritative.
Response
Person data retrieved successfully
Changes
- breaking
the response property
/became nullable for the status - breaking
the response property
/became nullable for the status - breaking
the response property
/became optional for the status - breaking
the response property
/became optional for the status - breaking
the response property
/became optional for the status - breaking
the response property
/became optional for the status - info
removed
subschema #2from the/response propertyanyOflist for the response status - info
removed
subschema #2from the/response propertyanyOflist for the response status - info
the
response's property default value422was added for the status - info
the
response's property default value500was added for the status - info
the
response's property default valueInternal Server Errorwas added for the status - info
the
response's property default valueUnprocessable Entitywas added for the status - info
removed the
100.00enum value from the/response property for the response status - info
removed the
100.00enum value from the/response property for the response status - info
removed the
101.00enum value from the/response property for the response status - info
removed the
101.00enum value from the/response property for the response status - info
removed the
102.00enum value from the/response property for the response status - info
removed the
102.00enum value from the/response property for the response status - info
removed the
103.00enum value from the/response property for the response status - info
removed the
103.00enum value from the/response property for the response status - info
removed the
200.00enum value from the/response property for the response status - info
removed the
200.00enum value from the/response property for the response status - info
removed the
201.00enum value from the/response property for the response status - info
removed the
201.00enum value from the/response property for the response status - info
removed the
202.00enum value from the/response property for the response status - info
removed the
202.00enum value from the/response property for the response status - info
removed the
203.00enum value from the/response property for the response status - info
removed the
203.00enum value from the/response property for the response status - info
removed the
204.00enum value from the/response property for the response status - info
removed the
204.00enum value from the/response property for the response status - info
removed the
205.00enum value from the/response property for the response status - info
removed the
205.00enum value from the/response property for the response status - info
removed the
206.00enum value from the/response property for the response status - info
removed the
206.00enum value from the/response property for the response status - info
removed the
207.00enum value from the/response property for the response status - info
removed the
207.00enum value from the/response property for the response status - info
removed the
208.00enum value from the/response property for the response status - info
removed the
208.00enum value from the/response property for the response status - info
removed the
226.00enum value from the/response property for the response status - info
removed the
226.00enum value from the/response property for the response status - info
removed the
300.00enum value from the/response property for the response status - info
removed the
300.00enum value from the/response property for the response status - info
removed the
301.00enum value from the/response property for the response status - info
removed the
301.00enum value from the/response property for the response status - info
removed the
302.00enum value from the/response property for the response status - info
removed the
302.00enum value from the/response property for the response status - info
removed the
303.00enum value from the/response property for the response status - info
removed the
303.00enum value from the/response property for the response status - info
removed the
304.00enum value from the/response property for the response status - info
removed the
304.00enum value from the/response property for the response status - info
removed the
305.00enum value from the/response property for the response status - info
removed the
305.00enum value from the/response property for the response status - info
removed the
307.00enum value from the/response property for the response status - info
removed the
307.00enum value from the/response property for the response status - info
removed the
308.00enum value from the/response property for the response status - info
removed the
308.00enum value from the/response property for the response status - info
removed the
400.00enum value from the/response property for the response status - info
removed the
400.00enum value from the/response property for the response status - info
removed the
401.00enum value from the/response property for the response status - info
removed the
401.00enum value from the/response property for the response status - info
removed the
402.00enum value from the/response property for the response status - info
removed the
402.00enum value from the/response property for the response status - info
removed the
403.00enum value from the/response property for the response status - info
removed the
403.00enum value from the/response property for the response status - info
removed the
404.00enum value from the/response property for the response status - info
removed the
404.00enum value from the/response property for the response status - info
removed the
405.00enum value from the/response property for the response status - info
removed the
405.00enum value from the/response property for the response status - info
removed the
406.00enum value from the/response property for the response status - info
removed the
406.00enum value from the/response property for the response status - info
removed the
407.00enum value from the/response property for the response status - info
removed the
407.00enum value from the/response property for the response status - info
removed the
408.00enum value from the/response property for the response status - info
removed the
408.00enum value from the/response property for the response status - info
removed the
409.00enum value from the/response property for the response status - info
removed the
409.00enum value from the/response property for the response status - info
removed the
410.00enum value from the/response property for the response status - info
removed the
410.00enum value from the/response property for the response status - info
removed the
411.00enum value from the/response property for the response status - info
removed the
411.00enum value from the/response property for the response status - info
removed the
412.00enum value from the/response property for the response status - info
removed the
412.00enum value from the/response property for the response status - info
removed the
413.00enum value from the/response property for the response status - info
removed the
413.00enum value from the/response property for the response status - info
removed the
413.00enum value from the/response property for the response status - info
removed the
413.00enum value from the/response property for the response status - info
removed the
414.00enum value from the/response property for the response status - info
removed the
414.00enum value from the/response property for the response status - info
removed the
414.00enum value from the/response property for the response status - info
removed the
414.00enum value from the/response property for the response status - info
removed the
415.00enum value from the/response property for the response status - info
removed the
415.00enum value from the/response property for the response status - info
removed the
416.00enum value from the/response property for the response status - info
removed the
416.00enum value from the/response property for the response status - info
removed the
416.00enum value from the/response property for the response status - info
removed the
416.00enum value from the/response property for the response status - info
removed the
417.00enum value from the/response property for the response status - info
removed the
417.00enum value from the/response property for the response status - info
removed the
418.00enum value from the/response property for the response status - info
removed the
418.00enum value from the/response property for the response status - info
removed the
421.00enum value from the/response property for the response status - info
removed the
421.00enum value from the/response property for the response status - info
removed the
422.00enum value from the/response property for the response status - info
removed the
422.00enum value from the/response property for the response status - info
removed the
422.00enum value from the/response property for the response status - info
removed the
422.00enum value from the/response property for the response status - info
removed the
423.00enum value from the/response property for the response status - info
removed the
423.00enum value from the/response property for the response status - info
removed the
424.00enum value from the/response property for the response status - info
removed the
424.00enum value from the/response property for the response status - info
removed the
425.00enum value from the/response property for the response status - info
removed the
425.00enum value from the/response property for the response status - info
removed the
426.00enum value from the/response property for the response status - info
removed the
426.00enum value from the/response property for the response status - info
removed the
428.00enum value from the/response property for the response status - info
removed the
428.00enum value from the/response property for the response status - info
removed the
429.00enum value from the/response property for the response status - info
removed the
429.00enum value from the/response property for the response status - info
removed the
431.00enum value from the/response property for the response status - info
removed the
431.00enum value from the/response property for the response status - info
removed the
451.00enum value from the/response property for the response status - info
removed the
451.00enum value from the/response property for the response status - info
removed the
500.00enum value from the/response property for the response status - info
removed the
500.00enum value from the/response property for the response status - info
removed the
501.00enum value from the/response property for the response status - info
removed the
501.00enum value from the/response property for the response status - info
removed the
502.00enum value from the/response property for the response status - info
removed the
502.00enum value from the/response property for the response status - info
removed the
503.00enum value from the/response property for the response status - info
removed the
503.00enum value from the/response property for the response status - info
removed the
504.00enum value from the/response property for the response status - info
removed the
504.00enum value from the/response property for the response status - info
removed the
505.00enum value from the/response property for the response status - info
removed the
505.00enum value from the/response property for the response status - info
removed the
506.00enum value from the/response property for the response status - info
removed the
506.00enum value from the/response property for the response status - info
removed the
507.00enum value from the/response property for the response status - info
removed the
507.00enum value from the/response property for the response status - info
removed the
508.00enum value from the/response property for the response status - info
removed the
508.00enum value from the/response property for the response status - info
removed the
510.00enum value from the/response property for the response status - info
removed the
510.00enum value from the/response property for the response status - info
removed the
511.00enum value from the/response property for the response status - info
removed the
511.00enum value from the/response property for the response status
- breaking
- breaking
the response property
/became nullable for the status - breaking
the response property
/became optional for the status - breaking
the response property
/became optional for the status - warning
deleted the
headerrequest parameterX-Api-Key - warning
added the new
tollfreeenum value to the///response property for the response status - info
api operation id
get_person_v1_person__getremoved and replaced withsearch_person_by_name_phone_or_address - info
endpoint deprecated
- info
added the new optional
queryrequest parameterfirst_name - info
added the new optional
queryrequest parameterinclude_historical_locations - info
added the new optional
queryrequest parameterlast_name - info
added the new optional
queryrequest parametermax_age - info
added the new optional
queryrequest parametermiddle_name - info
added the new optional
queryrequest parametermin_age - info
added the new optional
queryrequest parameterradius - info
added the new optional
queryrequest parameterstrict_match - info
for the
queryrequest parameterstate_code, the type was generalized from no type tostring - info
added the non-success response with the status
- info
removed the non-success response with the status
- info
removed the non-success response with the status
- info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
///to the response with the status - info
added the optional property
///to the response with the status - info
added the optional property
///to the response with the status - info
added the optional property
///to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
removed
subschema #2from the/response propertyanyOflist for the response status - info
the
response's property default value400was added for the status - info
the
response's property default valueBad Requestwas added for the status - info
removed the
100.00enum value from the/response property for the response status - info
removed the
101.00enum value from the/response property for the response status - info
removed the
102.00enum value from the/response property for the response status - info
removed the
103.00enum value from the/response property for the response status - info
removed the
200.00enum value from the/response property for the response status - info
removed the
201.00enum value from the/response property for the response status - info
removed the
202.00enum value from the/response property for the response status - info
removed the
203.00enum value from the/response property for the response status - info
removed the
204.00enum value from the/response property for the response status - info
removed the
205.00enum value from the/response property for the response status - info
removed the
206.00enum value from the/response property for the response status - info
removed the
207.00enum value from the/response property for the response status - info
removed the
208.00enum value from the/response property for the response status - info
removed the
226.00enum value from the/response property for the response status - info
removed the
300.00enum value from the/response property for the response status - info
removed the
301.00enum value from the/response property for the response status - info
removed the
302.00enum value from the/response property for the response status - info
removed the
303.00enum value from the/response property for the response status - info
removed the
304.00enum value from the/response property for the response status - info
removed the
305.00enum value from the/response property for the response status - info
removed the
307.00enum value from the/response property for the response status - info
removed the
308.00enum value from the/response property for the response status - info
removed the
400.00enum value from the/response property for the response status - info
removed the
401.00enum value from the/response property for the response status - info
removed the
402.00enum value from the/response property for the response status - info
removed the
403.00enum value from the/response property for the response status - info
removed the
404.00enum value from the/response property for the response status - info
removed the
405.00enum value from the/response property for the response status - info
removed the
406.00enum value from the/response property for the response status - info
removed the
407.00enum value from the/response property for the response status - info
removed the
408.00enum value from the/response property for the response status - info
removed the
409.00enum value from the/response property for the response status - info
removed the
410.00enum value from the/response property for the response status - info
removed the
411.00enum value from the/response property for the response status - info
removed the
412.00enum value from the/response property for the response status - info
removed the
413.00enum value from the/response property for the response status - info
removed the
413.00enum value from the/response property for the response status - info
removed the
414.00enum value from the/response property for the response status - info
removed the
414.00enum value from the/response property for the response status - info
removed the
415.00enum value from the/response property for the response status - info
removed the
416.00enum value from the/response property for the response status - info
removed the
416.00enum value from the/response property for the response status - info
removed the
417.00enum value from the/response property for the response status - info
removed the
418.00enum value from the/response property for the response status - info
removed the
421.00enum value from the/response property for the response status - info
removed the
422.00enum value from the/response property for the response status - info
removed the
422.00enum value from the/response property for the response status - info
removed the
423.00enum value from the/response property for the response status - info
removed the
424.00enum value from the/response property for the response status - info
removed the
425.00enum value from the/response property for the response status - info
removed the
426.00enum value from the/response property for the response status - info
removed the
428.00enum value from the/response property for the response status - info
removed the
429.00enum value from the/response property for the response status - info
removed the
431.00enum value from the/response property for the response status - info
removed the
451.00enum value from the/response property for the response status - info
removed the
500.00enum value from the/response property for the response status - info
removed the
501.00enum value from the/response property for the response status - info
removed the
502.00enum value from the/response property for the response status - info
removed the
503.00enum value from the/response property for the response status - info
removed the
504.00enum value from the/response property for the response status - info
removed the
505.00enum value from the/response property for the response status - info
removed the
506.00enum value from the/response property for the response status - info
removed the
507.00enum value from the/response property for the response status - info
removed the
508.00enum value from the/response property for the response status - info
removed the
510.00enum value from the/response property for the response status - info
removed the
511.00enum value from the/response property for the response status
- breaking