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