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

🚧

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.

ConnectionWindow

string

Provides insight into when the best time to contact the consumer is, allowing you to optimize dialing queue throughout the day for optimized results

ContactabilityScore

string

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

Contactability 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

Connection Window

Provides insight into when the best time to contact the consumer is, allowing you to optimize the dialing queue throughout the day for optimized results.

Assume the example: HHHHIIIJ

  • The first digit "H" corresponds to the best time range per the table below.
  • The last 7 digits correspond to the best time by day of the week, with the second digit being Monday and the last digit being Sunday

Assume the example: HHHHIIIJ:
H => 12:00PM – 4:00PM (GMT)
H => 12:00PM – 4:00PM (GMT) - Monday
H => 12:00PM – 4:00PM (GMT) - Teusday
H => 12:00PM – 4:00PM (GMT) - Wednesday
I => 4:00PM – 8:00PM (GMT) - Thursday
I => 4:00PM – 8:00PM (GMT) - Friday
I => 4:00PM – 8:00PM (GMT) - Saturday
J => 4:00PM – 8:00PM (GMT) - Sunday

Code

Description

A-B

12:00AM – 4:00AM (GMT)

C-D

4:00AM – 8:00AM (GMT)

E-F

8:00AM – 12:00PM (GMT)

G-H

12:00PM – 4:00PM (GMT)

I-J

4:00PM – 8:00PM (GMT)

K-L

8:00PM – 12:00AM (GMT)

N

No Data Available

LineType codes

Click for a list of LineType codes and descriptions.

HTTP Error Messages

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

Language
Click Try It! to start a request and see the response here!