Reverse Consumer Phone Append

Add name and US postal address to your contact records using a landline or mobile phone number.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
🚧

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 nameTypeDescription
FirstNamestringListing identity's first name
LastNamestringListing identity's last name
AddressstringPostal address
CitystringCity
StatestringState
PostalCodestring5 digit postal code
SourceenumIndicates 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.

Path Params
string
required

License key issued by customer support. Click here for a trial key

Query Params
string
required

10 digit numeric U.S. phone number

string

Optional. Return only listings that match first name.

string

Optional. Return only listings that match last name.

string
required

Semi-colon delimited list of target Sources to search. Click here for for a list of Source codes and descriptions.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/plain