--- updatedAt: 2026-09-21T08:50:41.000Z agentTools: projectIndex: https://docs.trustfull.com/llms.txt --- # Data Schema 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 | Name | Description | | :-------------------- | :------------------------------------------------------------- | | customer\_id | Customer id provided during the API call | | resolution\_id | Resolution id which identifies user document within TRUSTFULL. | | device\_request\_time | The Date Time when the request was made | ## Phone Signals | Name | Type | Description | | --------------------------------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 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, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, OS, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, YE, YT, ZA, ZM, ZW, XK | | 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\` | **DEPRECATED** If the phone number is associated with a WhatsApp profile

Ex: | | phone\_whatsapp\_privacy\_status | \`string\` | **DEPRECATED** 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: | | 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, UNKNOWN, EMERGENCY, VOICEMAIL, SHORT\_CODE, STANDARD\_RATE | | 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\_ea | \`boolean\` | If the phone number provided has been found on EA

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":\[""],"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":\["","count":1]}],"phones":\[]} | | phone\_data\_breaches\_name\_consistency | \`string\` | Contains a string value which can be MATCH, PARTIAL\_MATCH, NO\_MATCH explaining if names found in data breaches associated with the phone number are consistent.

Ex: MATCH | | phone\_data\_breaches\_email\_consistency | \`string\` | Contains a string value which can be MATCH, PARTIAL\_MATCH, NO\_MATCH explaining if emails found in data breaches associated with the phone number are consistent.

Ex: MATCH | | phone\_has\_linkedin | \`boolean\` | **DEPRECATED** 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\` | **DEPRECATED** Equal to true if the phone is linked or has a Skype account

Ex: true | | phone\_skype\_profile\_picture | \`string\` | **DEPRECATED** A public URL containing the Skype profile picture

Ex: | | phone\_skype\_city | \`string\` | **DEPRECATED** The name of the city registered in the Skype account

Ex: Milan | | phone\_skype\_country\_code | \`string\` | **DEPRECATED** 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, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, OS, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, YE, YT, ZA, ZM, ZW, XK | | phone\_skype\_country | \`string\` | **DEPRECATED** The name of the country registered in the Skype account

Ex: Lombardy | | phone\_skype\_state | \`string\` | **DEPRECATED** The name of the state registered in the Skype account

Ex: Italy | | phone\_skype\_name | \`string\` | **DEPRECATED** The name of the user registered in the Skype account

Ex: Mario | | phone\_skype\_id | \`string\` | **DEPRECATED** 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\` | **DEPRECATED** Indicates if the phone have been found on Bukalapak

Ex: true | | phone\_bukalapak\_has\_whatsapp\_otp | \`boolean\` | **DEPRECATED** 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\` | **DEPRECATED** If the phone number is associated with a WhatsApp Business profile

Ex: true | | phone\_whatsapp\_business\_email | \`string\` | **DEPRECATED**
Contains the email address linked to the WhatsApp Business profile

Ex: | | phone\_whatsapp\_business\_category | \`string\` | **DEPRECATED**
Contains the category of the business linked to the WhatsApp Business profile

Ex: Technology | | phone\_whatsapp\_business\_description | \`string\` | **DEPRECATED**
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\` | **DEPRECATED**
Indicates the review status of the product linked to the WhatsApp Business profile

Ex: APPROVED | | phone\_whatsapp\_business\_products\_price\_avg | \`number\` | **DEPRECATED**
Indicates the average price of the products linked to the WhatsApp Business profile

Ex: 55000 | | phone\_whatsapp\_business\_products\_price\_std | \`number\` | **DEPRECATED**
Indicates the standard deviation of the products linked to the WhatsApp Business profile

Ex: 0.0 | | phone\_whatsapp\_business\_products\_currencies | \`string\` | **DEPRECATED**
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\` | **DEPRECATED** 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\_first\_seen\_days | \`integer\` | Indicates the number of days since the provided phone number exists in our system

Ex: 1500 | | 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\_to\_username | \`string\` | A json string representing the most likely username extracted across all the sources of the phone number

Ex: \{"value":"john\_doe","confidence":"HIGH"} | | phone\_has\_to\_username | \`boolean\` | Indicates if the phone number has username information

Ex: true | | phone\_has\_to\_username\_confidence | \`string\` | Indicates the confidence level for the username extraction from the phone number

Ex: HIGH | | phone\_has\_image\_reverse\_search | \`string\` | **DEPRECATED** It shows if there are reverse search results for all, none or some profile pictures

Ex: ALL | | phone\_image\_reverse\_search | \`string\` | **DEPRECATED** 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\` | **DEPRECATED** 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\` | **DEPRECATED** 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\` | **DEPRECATED** 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\` | **DEPRECATED** 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\` | **DEPRECATED** The social or messaging app in that has this photo as profile picture:

- **telegram**
- **whatsapp**
- **skype**


Ex: whatsapp

Enum: telegram, whatsapp, skype | | phone\_to\_email | \`string\` | A json string representing the most likely email extracted across all the sources of the phone number.

Ex: \{"value":"1\*\*\*\*\*@g\*\*\*\*\*.com","confidence":"MEDIUM"} | | phone\_has\_to\_email | \`boolean\` | Indicates if the phone number has email information

Ex: true | | phone\_has\_openai | \`boolean\` | Equal to true if the phone number is linked or has an OpenAI account

Ex: true | ## FAQ ### What does a `null` value mean? A field returned as `null` means Trustfull was unable to retrieve that specific information at the time of the call. A `null` is not equivalent to `false`: it states that the signal could not be determined, not that the check came back negative. A missing signal is not an explicit penalty on the score, but it cannot contribute its trust points either, so an identity that enriched only partially often scores lower than the same identity fully enriched. Repeating the request may retrieve the missing signals and change the score. ### Why does the dashboard show a different cluster name than the API? Trustfull uses two labels for the same five risk bands. `phone_score_cluster` returns the API value; the dashboard, Insights and the sandbox scenarios use the display label. They always refer to the same band. | API value | Dashboard label | Score range | | :--------- | :-------------- | :---------- | | very\_low | Poor | 0–225 | | low | Bad | 226–450 | | review | Moderate | 451–550 | | high | Good | 551–775 | | very\_high | High | 776–1000 | ### Is the name of the phone holder available? Yes, through the **Phone to Name** product. There is no standalone Email-to-Name endpoint: that data point is returned as a field inside the Email API. ### What does `phone_first_seen` tell me? When the returned `phone_first_seen` date matches the date of your request, the phone number was observed by Trustfull for the first time at the moment of that call. An earlier date means the number was already known before your request. ### Are landline numbers supported? No. Only mobile numbers are enriched and scored. A call for a fixed line is rejected with a `400` and the `FIXED_LINE` error. On an Onboarding call you can retry the request without the `phone` claim and `phone_number`. See [Deprecation Timeline](https://docs.trustfull.com/docs/deprecation-timeline). > For more information about how to perform an api call you can go to [Phone API](https://docs.trustfull.com/reference/phone-api#response-1)