GuidesRecipesAPI ReferenceChangelog
Guides
Start typing to search…

Phone Number

This section contains a reference to a full list of parameters returned by Trustfull, You can use this data catalogue as a reference in interpreting fields provided in our API responses.

General Data

NameDescription
customer_idCustomer id provided during the API call
resolution_idResolution id which identifies user document within TRUSTFULL.
device_request_timeThe Date Time when the request was made

Phone Signals

NameTypeDescription
phone_value`string`The phone number of the user provided during the API call

Ex: 39354789865
phone_type`string`DEPRECATED: use number_type this will be remove on the 2.0 version of the API

Indicates the phone type of the phone number provided is mobile or landline


Ex: mobile
phone_is_disposable`boolean`Indicates if the phone number belongs to a temporary phone service provider

Ex: true
phone_disposable_provider_name`string`When detected indicates the temporary phone service provider

Ex: anonymsms.com
phone_is_suspicious_format`boolean`Indicates if the phone number you provided has a suspicious format

Ex: false
phone_is_valid_format`boolean`Indicates if the phone number you provided has a valid format

Ex: true
phone_country_code`string`The country code of the location of the original network, in ISO3361 alpha-2

Ex: ES

Enum: AB, AD, AE, AF, AG, AI, AL, AM, AO, AQ, ...
phone_is_ported`boolean`Will indicate if the number has been ported from its Original Network to a different Current Network

Ex: true
phone_original_network`string`The network operator that the number was originally assigned to

Ex: Vodafone Italia S.p.A
phone_current_network`string`An arbitrary string specifying the current network operator name of the inspected phone number

Ex: Fastweb - full mvno TIM
phone_original_mno_code`string`The network operator code that the number was originally assigned to

Ex: 22209
phone_current_mno_code`string`The current network operator code of the inspected phone number

Ex: 22201
phone_has_whatsapp`boolean`If the phone number is associated with a WhatsApp profile

Ex: true
phone_whatsapp_image`string`If the phone number is associated with a WhatsApp profile

Ex: https://example.com/image.jpg
phone_whatsapp_privacy_status`string`Indicates if the WhatsApp account is public or private

Ex: public

Enum: public, private
phone_has_telegram`boolean`Indicates if the owner of the phone number provided has a Telegram profile

Ex: true
phone_telegram_image`string`A public URL containing the Telegram profile picture

Ex: https://example.com/image.jpg
phone_telegram_first_name`string`Will indicate the first name registered in the Telegram profile page

Ex: John
phone_telegram_last_name`string`Will indicate the last name registered in the Telegram profile page

Ex: Smith
phone_telegram_username`string`Will indicate the username registered in the Telegram profile page

Ex: john.smith
phone_telegram_privacy_status`string`Indicates the visibility of the user Telegram profile

Ex: public

Enum: public, private
phone_score`integer`A number ranging from 0 to 1000 represents the quality of the phone number

Ex: 900
phone_score_cluster`string`A cluster summarizing the quality of the phone number

Ex: very_high

Enum: very_low, low, review, high, very_high
phone_first_ported`string`A string in the format YYYY-MM-DD indicates the first portability event

Ex: 2017-01-01
phone_last_ported`string`A string in the format YYYY-MM-DD indicates the last portability event

Ex: 2020-02-02
phone_ported_times`integer`Will indicate the number of times this phone number changed network operator

Ex: 5
phone_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 rates


Ex: MOBILE

Enum: FIXED_LINE, MOBILE, FIXED_LINE_OR_MOBILE, TOLL_FREE, PREMIUM_RATE, SHARED_COST, VOIP, PERSONAL_NUMBER, PAGER, UAN, ...
phone_caller_type`string`Indicates the caller type, consumer or business

Ex: BUSINESS

Enum: BUSINESS, CONSUMER
phone_caller_company_name`string`Indicates the company name if the caller type is business

Ex: ACME Srl
phone_has_amazon`boolean`If the phone number provided has been found on Amazon

Ex: true
phone_has_google`boolean`If the phone number provided has been found on Google

Ex: true
phone_has_office365`boolean`If the phone number provided has been found on Office365

Ex: true
phone_has_instagram`boolean`If the phone number provided has been found on Instagram

Ex: true
phone_first_name`string`Indicates the first name of the phone number owner

Ex: Tony
phone_last_name`string`Indicates the last name of the phone number owner

Ex: Stark
phone_birth_date`string`Indicates the birth date of the phone number owner

Ex: 03-01-2018
phone_image_source`string`The social or messaging app in that has this photo as profile picture:

- telegram
- whatsapp
- skype


Ex: whatsapp

Enum: telegram, whatsapp, skype
phone_image_labels`string`List of labels associated with the photo and relative confidence, separated by "|". There are more than 3500 labels that might indicate bodyparts, people, animals, food, places, colors, events, musical instruments and so on. For more information about image labels you can go to Image Labels

Ex: Dimples,99.999710083008|Head,99.999710083008|Face,99.999710083008|...
phone_face1_labels`string`List of labels associated with the first face in the photo and relative confidence, separated by "|"

Ex: label1,98.2837|label2,91.23323
phone_face1_bounding_box`string`Coordinates of the first face found, in the format: Width, Height, Left, Top

Ex: 0.93,0.23,10,12
phone_face1_age_range`string`Age range of the first face found in the photo

Ex: 12-16
phone_face1_is_celebrity`boolean`Indicates whether the first face found in the photo matches a known celebrity

Ex: true
phone_face1_celebrity_name`string`When the first face found in the photo matches a celebrity, indicate the name

Ex: Robert Downey Jr.
phone_face2_labels`string`List of labels associated with the second face in the photo and relative confidence, separated by "|"

Ex: label1,98.2837|label2,91.23323
phone_face2_bounding_box`string`Coordinates of the second face found, in the format: Width, Height, Left, Top

Ex: 0.93,0.23,10,12
phone_face2_age_range`string`Age range of the second face found in the photo

Ex: 12-16
phone_face2_is_celebrity`boolean`Indicates whether the second face found in the photo matches a known celebrity

Ex: true
phone_face2_celebrity_name`string`When the second face found in the photo matches a celebrity, indicate the name

Ex: Robert Downey Jr.
phone_face3_labels`string`List of labels associated with the third face in the photo and relative confidence, separated by "|"

Ex: label1,98.2837|label2,91.23323
phone_face3_bounding_box`string`Coordinates of the third face found, in the format: Width, Height, Left, Top

Ex: 0.93,0.23,10,12
phone_face3_age_range`string`Age range of the third face found in the photo

Ex: 12-16
phone_face3_is_celebrity`boolean`Indicates whether the third face found in the photo matches a known celebrity

Ex: true
phone_face3_celebrity_name`string`When the third face found in the photo matches a celebrity, indicate the name

Ex: Robert Downey Jr.
phone_has_facebook`boolean`Indicates if the phone have been found in facebook

Ex: true
phone_data_breaches_count`integer`The total number of data breaches recorded for this phone number

Ex: 5
phone_data_breaches_first_breach`string`If a data breach has been found, indicates the date of the first data breach

Ex: 2005-01-01
phone_data_breaches_last_breach`string`If a data breach has been found, indicates the date of the last data breach

Ex: 2023-01-02
phone_data_breaches_list`string`List of the first 10 data breaches, including data breach name and date

Ex: Databreach#1,2016-10-13|Databreach#2,2021-05-10|Databreach#3,2023-01-01
phone_data_breaches_data`string`Contains the data breaches, returned in json format, linked to the phone number

Ex: [{"id":"41720","date":"2023-03-09","title":"Sensitive Source"},{"id":"40870","date":"2023-01-06","title":"Deezer"},{"id":"37248","date":"2021-03-04","title":"Sensitive Source"},{"id":"18023","date":"2020-09-17","title":"Scraped Gravatar Profiles"},{"id":"17871","date":"2020-08-13","title":"\"AntiPub Drugs Squad\" Combolist"},{"id":"16296","date":"2018-11-29","title":"Sensitive Source"},{"id":"259","date":"2017-03-15","title":"GeekedIn"},{"id":"407","names":[{"first_name":"Peter","last_name":"Parker"},{"first_name":"Tony","last_name":"Stark"}],"emails":["[email protected]"],"date":"2017-01-16","title":"GeckoVPN,| SuperVPN"}]
phone_data_breaches_data_lists`string`Contains the data breaches list aggregated by names, emails and phones linked to the phone number

Ex: {"names":[{"first_name":"Peter","last_name":"Parker","count":1},{"first_name":"Tony","last_name":"Stark","count":1}],"emails":[{"id":"some", "emails":["[email protected]","count":1]}],"phones":[]}
phone_has_linkedin`boolean`Indicates if the phone have been found in linkedin

Ex:
phone_has_twitter`boolean`Indicates if the phone have been found in twitter

Ex: true
phone_has_skype`boolean`Equal to true if the phone is linked or has a Skype account

Ex: true
phone_skype_profile_picture`string`A public URL containing the Skype profile picture

Ex: https://example.com/image.jpg
phone_skype_city`string`The name of the city registered in the Skype account

Ex: Milan
phone_skype_country_code`string`The international country code registered in the Skype account, in ISO3166 alpha-2

Ex: IT

Enum: AB, AD, AE, AF, AG, AI, AL, AM, AO, AQ, ...
phone_skype_country`string`The name of the country registered in the Skype account

Ex: Lombardy
phone_skype_state`string`The name of the state registered in the Skype account

Ex: Italy
phone_skype_name`string`The name of the user registered in the Skype account

Ex: Mario
phone_skype_id`string`The skype username of the account associated to the phone

Ex: live:cid1234567
phone_phone_partials_count`integer`Contains the number of partial phone numbers linked to the phone number

Ex: 1
phone_phone_partials_list`string`Contains the aggregated partial phone numbers linked to the phone number

Ex: *********58
phone_email_partials_count`integer`Contains the number of partial email address linked to the phone number

Ex: 2
phone_email_partials_list`string`Contains the aggregated partial email address linked to the phone number

Ex: t***@g****.,t.s****@g****.***
phone_has_flipkart`boolean`Indicates if the phone have been found on Flipkart

Ex: true
phone_reason_codes`string`Comma separated risk and trust signal for the product phone.
For more information about reason codes you can go to Reason Codes

Ex: TP001,RP001
phone_has_bukalapak`boolean`Indicates if the phone have been found on Bukalapak

Ex: true
phone_bukalapak_has_whatsapp_otp`boolean`Equal to true if the Bukalapak account is linked with a Whatsapp account

Ex: true
phone_has_didi`boolean`Indicates if the phone number is associated with a Didi account

Ex: true
phone_has_aliexpress`boolean`Indicates if the phone number is associated with an Aliexpress account

Ex: true
phone_has_apple`boolean`Indicates if the phone have been found on Apple

Ex: true
phone_is_whatsapp_business`boolean`If the phone number is associated with a WhatsApp Business profile

Ex: true
phone_whatsapp_business_email`string`Contains the email address linked to the WhatsApp Business profile

Ex: [email protected]
phone_whatsapp_business_category`string`Contains the category of the business linked to the WhatsApp Business profile

Ex: Technology
phone_whatsapp_business_description`string`Contains the description of the business linked to the WhatsApp Business profile

Ex: We are a technology company
phone_whatsapp_business_products_review_status`string`Indicates the review status of the product linked to the WhatsApp Business profile

Ex: APPROVED
phone_whatsapp_business_products_price_avg`number`Indicates the average price of the products linked to the WhatsApp Business profile

Ex: 55000
phone_whatsapp_business_products_price_std`number`Indicates the standard deviation of the products linked to the WhatsApp Business profile

Ex: 0.0
phone_whatsapp_business_products_currencies`string`Indicates the currencies of the products linked to the WhatsApp Business profile

Ex: USD
phone_image2_source`string`The social or messaging app in that has this photo as profile picture:

- telegram
- whatsapp
- skype


Ex: whatsapp

Enum: telegram, whatsapp, skype
phone_image2_labels`string`List of labels associated with the photo and relative confidence, separated by "|". There are more than 3500 labels that might indicate bodyparts, people, animals, food, places, colors, events, musical instruments and so on.
List of labels associated with the photo and relative confidence, separated by "|". There are more than 3500 labels that might indicate bodyparts, people, animals, food, places, colors, events, musical instruments and so on. For more information about image labels you can go to Image Labels

Ex: Dimples,99.999710083008|Head,99.999710083008|Face,99.999710083008|...
phone_image2_face1_labels`string`List of labels associated with the first face in the photo and relative confidence, separated by "|"

Ex: label1,98.2837|label2,91.23323
phone_image2_face1_bounding_box`string`Coordinates of the first face found, in the format: Width, Height, Left, Top

Ex: 0.93,0.23,10,12
phone_image2_face1_age_range`string`Age range of the first face found in the photo

Ex: 12-16
phone_image2_face1_is_celebrity`boolean`Indicates whether the first face found in the photo matches a known celebrity

Ex: true
phone_image2_face1_celebrity_name`string`When the first face found in the photo matches a celebrity, indicate the name

Ex: Robert Downey Jr.
phone_image2_face2_labels`string`List of labels associated with the second face in the photo and relative confidence, separated by "|"

Ex: label1,98.2837|label2,91.23323
phone_image2_face2_bounding_box`string`Coordinates of the second face found, in the format: Width, Height, Left, Top

Ex: 0.93,0.23,10,12
phone_image2_face2_age_range`string`Age range of the second face found in the photo

Ex: 12-16
phone_image2_face2_is_celebrity`boolean`Indicates whether the second face found in the photo matches a known celebrity

Ex: true
phone_image2_face2_celebrity_name`string`When the second face found in the photo matches a celebrity, indicate the name

Ex: Robert Downey Jr.
phone_image2_face3_labels`string`List of labels associated with the third face in the photo and relative confidence, separated by "|"

Ex: label1,98.2837|label2,91.23323
phone_image2_face3_bounding_box`string`Coordinates of the third face found, in the format: Width, Height, Left, Top

Ex: 0.93,0.23,10,12
phone_image2_face3_age_range`string`Age range of the third face found in the photo

Ex: 12-16
phone_image2_face3_is_celebrity`boolean`Indicates whether the third face found in the photo matches a known celebrity

Ex: true
phone_image2_face3_celebrity_name`string`When the third face found in the photo matches a celebrity, indicate the name

Ex: Robert Downey Jr.
phone_image3_source`string`The social or messaging app in that has this photo as profile picture:

- telegram
- whatsapp
- skype


Ex: whatsapp

Enum: telegram, whatsapp, skype
phone_image3_labels`string`List of labels associated with the photo and relative confidence, separated by "|". There are more than 3500 labels that might indicate bodyparts, people, animals, food, places, colors, events, musical instruments and so on.
List of labels associated with the photo and relative confidence, separated by "|". There are more than 3500 labels that might indicate bodyparts, people, animals, food, places, colors, events, musical instruments and so on. For more information about image labels you can go to Image Labels

Ex: Dimples,99.999710083008|Head,99.999710083008|Face,99.999710083008|...
phone_image3_face1_labels`string`List of labels associated with the first face in the photo and relative confidence, separated by "|"

Ex: label1,98.2837|label2,91.23323
phone_image3_face1_bounding_box`string`Coordinates of the first face found, in the format: Width, Height, Left, Top

Ex: 0.93,0.23,10,12
phone_image3_face1_age_range`string`Age range of the first face found in the photo

Ex: 12-16
phone_image3_face1_is_celebrity`boolean`Indicates whether the first face found in the photo matches a known celebrity

Ex: true
phone_image3_face1_celebrity_name`string`When the first face found in the photo matches a celebrity, indicate the name

Ex: Robert Downey Jr.
phone_image3_face2_labels`string`List of labels associated with the second face in the photo and relative confidence, separated by "|"

Ex: label1,98.2837|label2,91.23323
phone_image3_face2_bounding_box`string`Coordinates of the second face found, in the format: Width, Height, Left, Top

Ex: 0.93,0.23,10,12
phone_image3_face2_age_range`string`Age range of the second face found in the photo

Ex: 12-16
phone_image3_face2_is_celebrity`boolean`Indicates whether the second face found in the photo matches a known celebrity

Ex: true
phone_image3_face2_celebrity_name`string`When the second face found in the photo matches a celebrity, indicate the name

Ex: Robert Downey Jr.
phone_image3_face3_labels`string`List of labels associated with the third face in the photo and relative confidence, separated by "|"

Ex: label1,98.2837|label2,91.23323
phone_image3_face3_bounding_box`string`Coordinates of the third face found, in the format: Width, Height, Left, Top

Ex: 0.93,0.23,10,12
phone_image3_face3_age_range`string`Age range of the third face found in the photo

Ex: 12-16
phone_image3_face3_is_celebrity`boolean`Indicates whether the third face found in the photo matches a known celebrity

Ex: true
phone_image3_face3_celebrity_name`string`When the third face found in the photo matches a celebrity, indicate the name

Ex: Robert Downey Jr.
phone_status`string`DEPRECATED: This will be removed on the 2.0 version of the API.

Use the score or score_cluster field:
- If score < 450 the phone number is likely to be NOT connected. Alternatively use score_cluster with values poor and bad.
- If score >= 450 the phone number is likely to be connected. Alternatively use score_cluster with values moderate good and high.

- connected: indicates that the number is valid and the target handset is currently connected to the network (and reachable)
- syntax: the phone number contains invalid characters, typos, or is formally incorrect
- invalid: indicates that the number is not currently assigned to any subscriber on the network or otherwise invalid
- unknown: indicates that the connectivity status could not be determined and the connectivity status is unknown.
This can be caused by invalid numbers, due to lack of connectivity to the target network operator, or other exceptions and errors.

Ex: connected

Enum: syntax, connected, disposable, unknown, invalid
phone_is_valid`boolean`DEPRECATED: This will be removed on the 2.0 version of the API.

Use the score or score_cluster field:
- If score < 450 the phone number is likely to be NOT connected. Alternatively use score_cluster with values poor and bad.
- If score >= 450 the phone number is likely to be connected. Alternatively use score_cluster with values moderate good and high.

Indicates if the phone number you provided is valid

Ex: true
phone_identity_device_count`integer`The number of devices associated with this phone number

Ex: 2
phone_identity_email_count`integer`The number of email addresses associated with this phone number

Ex: 2
phone_identity_ip_count`integer`The number of ip addresses associated with this phone number

Ex: 2
phone_identity_name_count`integer`The number of names associated with this phone number

Ex: 2
phone_faces_similarity1`boolean`Indicates whether the detected faces in the first group are considered a match.

Ex: true
phone_faces_similarity1_image1`string`The URL of the first image in the pair being compared.

Ex: https://...
phone_faces_similarity1_image2`string`The URL of the second image in the pair being compared.

Ex: https://...
phone_faces_similarity1_image1_bounding_box`string`Coordinates of the face in the first image of the pair being compared, in the format: Width, Height, Left, Top.

Ex: 0.93,0.23,10,12
phone_faces_similarity1_image2_bounding_box`string`Coordinates of the face in the second image of the pair being compared, in the format: Width, Height, Left, Top.

Ex: 0.93,0.23,10,12
phone_faces_similarity2`boolean`Indicates whether the detected faces in the second group are considered a match.

Ex: true
phone_faces_similarity2_image1`string`The URL of the first image in the pair being compared.

Ex: https://...
phone_faces_similarity2_image2`string`The URL of the second image in the pair being compared.

Ex: https://...
phone_faces_similarity2_image1_bounding_box`string`Coordinates of the face in the first image of the pair being compared, in the format: Width, Height, Left, Top.

Ex: 0.93,0.23,10,12
phone_faces_similarity2_image2_bounding_box`string`Coordinates of the face in the second image of the pair being compared, in the format: Width, Height, Left, Top.

Ex: 0.93,0.23,10,12
phone_faces_similarity3`boolean`Indicates whether the detected faces in the third group are considered a match.

Ex: true
phone_faces_similarity3_image1`string`The URL of the first image in the pair being compared.

Ex: https://...
phone_faces_similarity3_image2`string`The URL of the second image in the pair being compared.

Ex: https://...
phone_faces_similarity3_image1_bounding_box`string`Coordinates of the face in the first image of the pair being compared, in the format: Width, Height, Left, Top.

Ex: 0.93,0.23,10,12
phone_faces_similarity3_image2_bounding_box`string`Coordinates of the face in the second image of the pair being compared, in the format: Width, Height, Left, Top.

Ex: 0.93,0.23,10,12
phone_has_snapchat`boolean`Indicates if the phone number is associated with a Snapchat account

Ex: true
phone_has_weibo`boolean`Indicates if the phone number is associated with a Weibo account

Ex: true
phone_first_seen`string`The earliest date our system has on record for the phone number.

Ex: 2019-05-20
phone_to_name`string`A json string representing the most likely name extracted across all the sources of the phone number.

Ex: {"first_name":"tony", "last_name":"Stark", "confidence": "HIGH"}
phone_has_image_reverse_search`string`It shows if there are reverse search results for all, none or some profile pictures

Ex: ALL
phone_image_reverse_search`string`A JSON object containing the results of a reverse image search for the profile picture, including websites where the image appears along with the link, name, icon, and domain.

Ex:
phone_image_reverse_search_source`string`The social or messaging app in that has this photo as profile picture:

- telegram
- whatsapp
- skype


Ex: whatsapp

Enum: telegram, whatsapp, skype
phone_image2_reverse_search`string`A JSON object containing the results of a reverse image search for the profile picture, including websites where the image appears along with the link, name, icon, and domain.

Ex:
phone_image2_reverse_search_source`string`The social or messaging app in that has this photo as profile picture:

- telegram
- whatsapp
- skype


Ex: whatsapp

Enum: telegram, whatsapp, skype
phone_image3_reverse_search`string`A JSON object containing the results of a reverse image search for the profile picture, including websites where the image appears along with the link, name, icon, and domain.

Ex:
phone_image3_reverse_search_source`string`The social or messaging app in that has this photo as profile picture:

- telegram
- whatsapp
- skype


Ex: whatsapp

Enum: telegram, whatsapp, skype

For more information about how to perform an api call you can go to Phone API

Updated 3 days ago