Phone Validation

This endpoint allows you to check if a phone number is valid

Following an example of a Phone Validation

curl --request POST \
     --url https://api.trustfull.com/data/1.0/phone-validation \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'x-api-key: [your_app_key]' \
     --data '
{
     "transaction_id": "your_transaction_id",     
     "phone_number": "39349xxxxxxx"
}'

Here's a detailed explanation of all fields needed for the api call:

name	type
transaction_id	string A unique identifier for the transaction. Duplicate values are not allowed. Ex: 4115d9d9-28f4-4100-8701-cafe2adbc4c2
phone_number	string The phone number to analyze, in international format. Ex: 39349xxxxxxx

name

type

transaction_id

string

A unique identifier for the transaction. Duplicate values are not allowed.

Ex: 4115d9d9-28f4-4100-8701-cafe2adbc4c2

phone_number

string

The phone number to analyze, in international format.

Ex: 39349xxxxxxx

Response

Following is an example of the response:

{
  "is_valid_format": true,
  "is_suspicious_format": true, 
  "original_network_name": "Vodafone",
  "number_type":"FIXED_LINE"
  "country_code": "IT"
}

Here's a detailed explanation of all fields returned:

name	type
is_valid_format	boolean Indicates if the phone number you provided has a valid format Ex: true
is_suspicious_format	?boolean Indicates if the phone number you provided has a suspicious format Ex: 5
original_network_name	?string The network operator that the number was originally assigned to Ex: Vodafone Italia S.p.A
number_type	?string Indicates the type of phone number: FIXED_LINE: A fixed line phone number MOBILE: A mobile phone number FIXED_LINE_OR_MOBILE: A phone number that could be either fixed line or mobile TOLL_FREE: A toll-free phone number PREMIUM_RATE: A phone number that charges premium rates SHARED_COST: A phone number that shares the cost between caller and recipient VOIP: A phone number that uses voice-over IP technology PERSONAL_NUMBER: A personal phone number PAGER: A pager number UAN: A universal access number UNKNOWN: An unknown phone number type EMERGENCY: An emergency phone number VOICEMAIL: A voicemail number SHORT_CODE: A short code number STANDARD_RATE: A phone number that charges standard ratesEx: MOBILE
country_code	?string The international country code registered in the Skype account, in ISO3166 alpha-2 Ex: IT

FAQ

Following are some common questions for this specific API:

📘
Why do need to pass a transaction_id?
This value is useful to refer to a specific transaction in the system. Using only the phone number can lead to collision in case of duplicated call for the same phone number. Transaction id must be unique across all trustfull api endpoints.

📘
What is the supported phone_number_format?
The phone_number parameter must be submitted in international format, using digits only. This means the number should include the country code directly followed by the national number, without any leading zeros, plus symbols, spaces, or special characters.