🚧
HTTP Header
The "content-type" in the HTTP header must be set to "application/json", otherwise an HTTP 400 Bad Request response will be returned.

Making a request

The ReversePhone request closely mimics the logic and data sources used in our batch append service except it allows the user to programmatically make single calls using an API. Pass simple contact information such as first name, last name, city, state and physical address to look-up the email address of your customer.

Response Definitions

A single response may include one or more Record elements.

Field name	Type	Description
FirstName	string	Listing identity's first name
LastName	string	Listing identity's last name
Address	string	Postal address
City	string	City
State	string	State
PostalCode	string	5 digit postal code
Source	enum	Indicates Source where the match was found

Source
The returning source element will indicate if the phone number matched a specific database and may determine if the device used is a mobile phone or a landline phone. For a list of codes and descriptions click here.

HTTP Error Messages

Click to see a complete listing of error messages and codes.

200200

400400

401401

500500