Business Phone Append

Add business landline phone numbers to U.S. contact records by searching our database using existing contact fields such as business name, city, state, and postal address.

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 Accurate Append Business Phone Append Web API 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 a business name and physical address to look-up the phone numbers of your customer.

Sources

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.

MatchLevel

Business searches are conducted using a combination of business name, location and postal address match. The MatchLevel response field indicates how well the request fields sent to the API match the response fields. For example, a MatchLevel returned of BUS1 gives a high confidence that there is an exact match whereas a return of BUS2 states that business name does not necessarily make a match yet the address is a perfect match. BUS3 gives a low confidence that the business name matches yet the address is an exact match. For a list of MatchLevel codes and descriptions click here.

LineType

For a list of codes and descriptions click here.

HTTP Error Messages

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

Path Params
string
required

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

Query Params
string
required

Search subject's business name.

string

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

string
required

City associated with search subject's address. Optional, if postal code is passed in the request.

string
required

State associated with search subject's address. Optional, if postal code is passed in the request.

string

Postal code associated with search subject's address.

string

Semi-colon delimited list of target Sources to search. If omitted, source D;P;C will be selected. Sources are searched in the order they are entered. Click here for for a list of Source codes and descriptions.

string

Semi-colon delimited list of MatchLevels used to filter response. If omitted, the match levels BUS1;BUS2;BUS3;BUS4;BUS5;BUS6;BUS7 will be assumed. [Click for a list of MatchLevel codes and descriptions] (https://docs.accurateappend.com/reference#matchlevel-consumer-1).

boolean

Limits the service response to return the first match found and based on source preference. Example: If sources D;P;C are input and a match is found in D, the service would return the first match and nothing else.

string

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

Responses

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