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
or
http://api.whitepages.com/reverse_phone/1.0/?phone=9730000;state=WA;api_key=API_KEYVAL
Return to the main documentation page
Copyright © 2008 WhitePages.com. All rights reserved.
Comments