reverse_phone Search

Finds a name and contact information, based on a telephone number.

Syntax

http://api.whitepages.com/reverse_phone/1.0/?parameter_list;api_key=API_KEY

where parameter_list signifies one or more parameter=value entries separated by semicolons and API_KEY is the API key you received when you registered.

Parameters

Parameters can appear in any order. Parameter names are case-sensitive; parameter values case-insensitive. For example "state=wa" is equivalent to "state=WA", but "State=WA" is not a valid parameter assignment.

Parameter	Required?	Notes	Example
phone	yes	Can be 7 or 10 digits	phone=2069730000
state	Yes if phone is 7 digits	USPS two-character abbreviations only	state=WA

Remarks

The phone parameter is required and the state parameter is also required if the phone parameter value is 7 digits.

Limitations

A reverse_phone search will return at most 5 listings using the WhietPages.com API. Additional listings may be available by following one of the URLs returned as links with a successful search.

Example

The following examples specify a reverse phone search for the Seattle-area telephone number (206) 973-0000:

http://api.whitepages.com/reverse_phone/1.0/?phone=2069730000;api_key=API_KEYVAL

http://api.whitepages.com/reverse_phone/1.0/?phone=9730000;state=WA;api_key=API_KEYVAL