Guides
Data Services

Phone Verification Response Object

This object represents the response from the Phone Verification endpoint:

📘

Click on each object for more information

phone_verification object

This object contains detailed information about the verified phone number, including its type, carrier, status, and more.

phone_number string
The phone number that was verified.

line_type string
The type of phone line.
Possible Values:

  • mobile
  • landline
  • voip
  • toll_free
  • other

carrier string
Telephone number network operator.
Example: AT&T Wireless

status string
The status of the phone number.
Possible Values:

  • valid: structure/syntax of number is valid but AtData could not determine if it is in use.
  • invalid: Structure/syntax of number is invalid.
  • dead: Phone number structure is valid but number is disconnected/not in use.
  • live: Number is currently connected to a network and in use.
  • unknown: The status of the phone number could not be determined.

prepaid boolean
Telephone number is for a prepaid phone (US only).
Example: false

connected_score integer
A score from 0 to 100 indicating whether the phone is connected or not.
Applicable only for U.S. phone numbers.

  • A score of 70 or more means there is high confidence the phone is connected and dialable.
  • A score of 30 or lower means there is high confidence the phone is disconnected or no one will answer.

country_code string
The ISO-3166 alpha-2 country code of the phone number (e.g., US).

country_calling_code integer
The prefix for dialing the country (e.g., 1 for the US).