ADS Consumer Phone Append

get

https://api.accurateappend.com/Services/V2/AppendPhone/Ads/{licensekey}/

Add mobile and landline phone numbers to your contact records by searching our Authoritative Data Source database using existing contact fields such as first name, last name, city, state, and postal address.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

🚧
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.

Response

A single response may include one and only one Phone element for each Source requested.

Field name	Type	Description
Areacode	string	3 digit US area code
PhoneNumber	string	7 digit US phone number
LineType	enum	Indicates the LineType
MatchLevel	enum	Indicates the MatchLevel under which the match was found.
MaxValidationLevel	enum	Indicates the maximum validation level achieved by the input criteria. Measured as MatchLevel.
AccuReachScore	string	Indicates likelihood of right party contact, allowing you to identify which phones to dial and which phones to deprioritize.

AccuReach Score

Indicates likelihood of right party contact, allowing you to identify which phones to dial and which phones to deprioritize.

Code	Phone Type	Verified	Phone Usage (12 Months)	Phone Usage (2 Months)
A	Wireless	Yes	Moderate to Heavy	Moderate to Heavy
B	Wireless	No	Moderate to Heavy	Light to Heavy
C	Wireless	Yes	Moderate to Heavy	Light
E	Landline	Any	Moderate to Heavy	Light to Heavy
F	Wireless	Any	Any	Minimal
G	Any	Any	Moderate to Heavy	Any
I	Any	Any	Light	Any
J	Any	Any	Minimal	Any
K	Any	Any	None	Any

LineType codes

[Click for a list of LineType codes and descriptions] (https://docs.accurateappend.com/reference/linetype).

HTTP Error Messages

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

Path Params

licensekey

string

required

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

Query Params

firstname

string

required

Search subject's first name.

lastname

string

required

Search subject's last name. Full name can be passed into the lastname field. Our system will parse the contents of the field into first and last name for the purposes of the append.

address

string

required

Search subject's address. Currently only US postal addresses are accepted. Addresses are parsed and corrected by our system using CASS software prior to matching.

city

string

required

City associated with search subject's address.

state

string

required

State associated with search subject's address.

postalcode

string

required

Postal code associated with search subject's address. Optional, if city and state are passed in the request.

lineType

string

required

Semi-colon delimited list of listing types to return. Choices are S for land line and C for mobile phone. You can enter S;C and the system will attempt to return a listing for each requested line type.

suppression

string

Semi-colon delimited list containing up to 10 ten digit, numeric phone numbers to be suppressed from query and results.

addOns

string

Semi-colon delimited list containing options. i.e. AS. AS = AccuReachScore (See below for detailed descriptions)

Responses

HTTP Header

Response

AccuReach Score

LineType codes

HTTP Error Messages

200200

400400