Phone Number

value

string

The phone number of the user provided during the API call

Ex: 39354789865

type

string

• *DEPRECATED: usenumber_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

is_disposable

boolean

Indicates if the phone number belongs to a temporary phone service provider

Ex: true

disposable_provider_name

string

When detected indicates the temporary phone service provider

Ex: anonymsms.com

is_suspicious_format

boolean

Indicates if the phone number you provided has a suspicious format

Ex: false

is_valid_format

boolean

Indicates if the phone number you provided has a valid format

Ex: true

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

is_ported

boolean

Will indicate if the number has been ported from its Original Network to a different Current Network

Ex: true

original_network

string

The network operator that the number was originally assigned to

Ex: Vodafone Italia S.p.A

current_network

string

An arbitrary string specifying the current network operator name of the inspected phone number

Ex: Fastweb - full mvno TIM

has_whatsapp

boolean

If the phone number is associated with a WhatsApp profile

Ex: true

whatsapp_image

string

If the phone number is associated with a WhatsApp profile

Ex: https://example.com/image.jpg

whatsapp_privacy_status

string

Indicates if the WhatsApp account is public or private

Ex: public

Enum: public,private

has_telegram

boolean

Indicates if the owner of the phone number provided has a Telegram profile

Ex: true

telegram_image

string

A public URL containing the Telegram profile picture

Ex: https://example.com/image.jpg

telegram_first_name

string

Will indicate the first name registered in the Telegram profile page

Ex: John

telegram_last_name

string

Will indicate the last name registered in the Telegram profile page

Ex: Smith

telegram_username

string

Will indicate the username registered in the Telegram profile page

Ex: john.smith

telegram_privacy_status

string

Indicates the visibility of the user Telegram profile

Ex: public

Enum: public,private

score

integer

A number ranging from 0 to 1000 represents the quality of the phone number

Ex: 900

score_cluster

string

A cluster summarizing the quality of the phone number

Ex: very_high

Enum: very_low,low,review,high,very_high

first_ported

string

A string in the format YYYY-MM-DD indicates the first portability event

Ex: 2017-01-01

last_ported

string date

A string in the format YYYY-MM-DD indicates the last portability event

Ex: 2020-02-02

ported_times

integer

Will indicate the number of times this phone number changed network operator

Ex: 5

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

caller_type

string

Indicates the caller type, consumer or business

Ex: BUSINESS

Enum: BUSINESS,CONSUMER

caller_company_name

string

Indicates the company name if the caller type is business

Ex: ACME Srl

has_amazon

boolean

If the phone number provided has been found on Amazon

Ex: true

has_google

boolean

If the phone number provided has been found on Google

Ex: true

has_office365

boolean

If the phone number provided has been found on Office365

Ex: true

has_instagram

boolean

If the phone number provided has been found on Instagram

Ex: true

first_name

string

Indicates the first name of the phone number owner

Ex: Tony

last_name

string

Indicates the last name of the phone number owner

Ex: Stark

birth_date

string

Indicates the birth date of the phone number owner

Ex: 03-01-2018

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

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

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

face1_bounding_box

string

Coordinates of the first face found, in the format: Width, Height, Left, Top

Ex: 0.93,0.23,10,12

face1_age_range

string

Age range of the first face found in the photo

Ex: 12-16

face1_is_celebrity

boolean

Indicates whether the first face found in the photo matches a known celebrity

Ex: true

face1_celebrity_name

string

When the first face found in the photo matches a celebrity, indicate the name

Ex: Robert Downey Jr.

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

face2_bounding_box

string

Coordinates of the second face found, in the format: Width, Height, Left, Top

Ex: 0.93,0.23,10,12

face2_age_range

string

Age range of the second face found in the photo

Ex: 12-16

face2_is_celebrity

boolean

Indicates whether the second face found in the photo matches a known celebrity

Ex: true

face2_celebrity_name

string

When the second face found in the photo matches a celebrity, indicate the name

Ex: Robert Downey Jr.

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

face3_bounding_box

string

Coordinates of the third face found, in the format: Width, Height, Left, Top

Ex: 0.93,0.23,10,12

face3_age_range

string

Age range of the third face found in the photo

Ex: 12-16

face3_is_celebrity

boolean

Indicates whether the third face found in the photo matches a known celebrity

Ex: true

face3_celebrity_name

string

When the third face found in the photo matches a celebrity, indicate the name

Ex: Robert Downey Jr.

has_facebook

boolean

Indicates if the phone have been found in facebook

Ex: true

data_breaches_count

integer

The total number of data breaches recorded for this phone number

Ex: 5

data_breaches_first_breach

string

If a data breach has been found, indicates the date of the first data breach

Ex: 2005-01-01

data_breaches_last_breach

string

If a data breach has been found, indicates the date of the last data breach

Ex: 2023-01-02

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

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"}][{"first_name"":"Peter","last_name":"Parker"},{"first_name"":"Tony","last_name":"Stark"}],"emails":["[email protected]"]["[email protected]"],"date":"2017-01-16","title":"GeckoVPN,| SuperVPN"}]

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}][{"first_name"":"Peter","last_name":"Parker","count":1},{"first_name"":"Tony","last_name":"Stark","count":1}],"emails":[{"id":"some", "emails":["[email protected]","count":1]["[email protected]","count":1]}],"phones":[]}

has_linkedin

boolean

Indicates if the phone have been found in linkedin

Ex:

has_twitter

boolean

Indicates if the phone have been found in twitter

Ex: true

has_skype

boolean

Equal to true if the phone is linked or has a Skype account

Ex: true

skype_profile_picture

string

A public URL containing the Skype profile picture

Ex: https://example.com/image.jpg

skype_city

string

The name of the city registered in the Skype account

Ex: Milan

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

skype_country

string

The name of the country registered in the Skype account

Ex: Lombardy

skype_state

string

The name of the state registered in the Skype account

Ex: Italy

skype_name

string

The name of the user registered in the Skype account

Ex: Mario

skype_id

string

The skype username of the account associated to the phone

Ex: live:cid1234567

phone_partials_count

integer

Contains the number of partial phone numbers linked to the phone number

Ex: 1

phone_partials_list

string

Contains the aggregated partial phone numbers linked to the phone number

Ex: *58

email_partials_count

integer

Contains the number of partial email address linked to the phone number

Ex: 2

email_partials_list

string

Contains the aggregated partial email address linked to the phone number

Ex: t*@g**.,t.s**@g**.***

has_flipkart

boolean

Indicates if the phone have been found on Flipkart

Ex: true

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

has_viber

boolean

Indicates if the phone have been found on Viber

Ex: true

viber_last_seen

integer

The distance in days between the last access to Viber and the date of decoration

Ex: 1

viber_full_name

string

The name of the user registered in the Viber account

Ex: Mario

has_bukalapak

boolean

Indicates if the phone have been found on Bukalapak

Ex: true

bukalapak_has_whatsapp_otp

boolean

Equal to true if the Bukalapak account is linked with a Whatsapp account

Ex: true

has_apple

boolean

Indicates if the phone have been found on Apple

Ex: true

is_whatsapp_business

boolean

If the phone number is associated with a WhatsApp Business profile

Ex: true

whatsapp_business_email

string

Contains the email address linked to the WhatsApp Business profile

Ex: [email protected]

whatsapp_business_category

string

Contains the category of the business linked to the WhatsApp Business profile

Ex: Technology

whatsapp_business_description

string

Contains the description of the business linked to the WhatsApp Business profile

Ex: We are a technology company

whatsapp_business_products_review_status

string

Indicates the review status of the product linked to the WhatsApp Business profile

Ex: APPROVED

whatsapp_business_products_price_avg

number float

Indicates the average price of the products linked to the WhatsApp Business profile

Ex: 55000

whatsapp_business_products_price_std

number float

Indicates the standard deviation of the products linked to the WhatsApp Business profile

Ex: 0.0

whatsapp_business_products_currencies

string

Indicates the currencies of the products linked to the WhatsApp Business profile

Ex: USD

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

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

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

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

image2_face1_age_range

string

Age range of the first face found in the photo

Ex: 12-16

image2_face1_is_celebrity

boolean

Indicates whether the first face found in the photo matches a known celebrity

Ex: true

image2_face1_celebrity_name

string

When the first face found in the photo matches a celebrity, indicate the name

Ex: Robert Downey Jr.

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

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

image2_face2_age_range

string

Age range of the second face found in the photo

Ex: 12-16

image2_face2_is_celebrity

boolean

Indicates whether the second face found in the photo matches a known celebrity

Ex: true

image2_face2_celebrity_name

string

When the second face found in the photo matches a celebrity, indicate the name

Ex: Robert Downey Jr.

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

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

image2_face3_age_range

string

Age range of the third face found in the photo

Ex: 12-16

image2_face3_is_celebrity

boolean

Indicates whether the third face found in the photo matches a known celebrity

Ex: true

image2_face3_celebrity_name

string

When the third face found in the photo matches a celebrity, indicate the name

Ex: Robert Downey Jr.

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

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

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

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

image3_face1_age_range

string

Age range of the first face found in the photo

Ex: 12-16

image3_face1_is_celebrity

boolean

Indicates whether the first face found in the photo matches a known celebrity

Ex: true

image3_face1_celebrity_name

string

When the first face found in the photo matches a celebrity, indicate the name

Ex: Robert Downey Jr.

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

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

image3_face2_age_range

string

Age range of the second face found in the photo

Ex: 12-16

image3_face2_is_celebrity

boolean

Indicates whether the second face found in the photo matches a known celebrity

Ex: true

image3_face2_celebrity_name

string

When the second face found in the photo matches a celebrity, indicate the name

Ex: Robert Downey Jr.

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

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

image3_face3_age_range

string

Age range of the third face found in the photo

Ex: 12-16

image3_face3_is_celebrity

boolean

Indicates whether the third face found in the photo matches a known celebrity

Ex: true

image3_face3_celebrity_name

string

When the third face found in the photo matches a celebrity, indicate the name

Ex: Robert Downey Jr.

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

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

identity_device_count

integer

The number of devices associated with this phone number

Ex: 2

identity_email_count

integer

The number of email addresses associated with this phone number

Ex: 2

identity_ip_count

integer

The number of ip addresses associated with this phone number

Ex: 2

identity_name_count

integer

The number of names associated with this phone number

Ex: 2

faces_similarity1

boolean

Indicates whether the detected faces in the first group are considered a match.

Ex: true

faces_similarity1_image1

string

The URL of the first image in the pair being compared.

Ex: https://...

faces_similarity1_image2

string

The URL of the second image in the pair being compared.

Ex: https://...

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

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

faces_similarity2

boolean

Indicates whether the detected faces in the second group are considered a match.

Ex: true

faces_similarity2_image1

string

The URL of the first image in the pair being compared.

Ex: https://...

faces_similarity2_image2

string

The URL of the second image in the pair being compared.

Ex: https://...

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

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

faces_similarity3

boolean

Indicates whether the detected faces in the third group are considered a match.

Ex: true

faces_similarity3_image1

string

The URL of the first image in the pair being compared.

Ex: https://...

faces_similarity3_image2

string

The URL of the second image in the pair being compared.

Ex: https://...

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

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

has_snapchat

boolean

Indicates if the phone number is associated with a Snapchat account

Ex: true

has_weibo

boolean

Indicates if the phone number is associated with a Weibo account

Ex: true

first_seen

string

The earliest date our system has on record for the phone number.

Ex: 2019-05-20

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"}

has_image_reverse_search

string

It shows if there are reverse search results for all, none or some profile pictures

Ex: ALL

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:

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

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:

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

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:

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