---
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 |
## Ip Signals
| Name | Type | Description |
| ---------------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ip\_value | \`string\` | The IP address provided during the API call, can either be an ipv4 or ipv6
Ex: 12.34.56.78 |
| ip\_city | \`string\` | The city associated to the IP address of the customer
Ex: Milan |
| ip\_connection\_speed | \`string\` | Internet connection speed associated to the ip address:
- **company/T1**
- **broadband/cable/fiber**
- **mobile**
Ex: company/T1
Enum: company/T1, broadband/cable/fiber, mobile |
| ip\_connection\_type | \`string\` | Usage type classification of ISP or company:
- **Commercial**
- **Content Delivery Network**
- **Fixed Line**
- **Mobile ISP**
- **Reserved**
- **University / College / School**
Ex: Reserved
Enum: Commercial, Content Delivery Network, Fixed Line, Mobile ISP, Reserved, University / College / School |
| ip\_country | \`string\` | The name of the country where the IP Address is located, ISO 3166 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 |
| ip\_lat | \`string\` | The latitude for where place where the IP Address is located
Ex: 55.7522 |
| ip\_lon | \`string\` | The longitude for where place where the IP Address is located
Ex: 37.6156 |
| ip\_isp | \`string\` | The service provider used by the customer's device to access the internet
Ex: Fastweb |
| ip\_timezone | \`string\` | The exact current time in the Timezone the IP address belongs to
Ex: CET |
| ip\_request\_time | \`string\` | Time of the day the user is requesting your service
Ex: night
Enum: morning, afternoon, evening, night |
| ip\_zip | \`string\` | The Postal Code for where the IP Address is located
Ex: 20124 |
| ip\_is\_mobile | \`boolean\` | Indicates whether an IP address is associated with a mobile connection
Ex: true |
| ip\_is\_vpn | \`boolean\` | Indicates whether an IP address is under a VPN
Ex: true |
| ip\_vpn\_name | \`string\` | **DEPRECATED** If the IP address is a VPN, it is the name of the VPN provider
Ex: NordVPN |
| ip\_is\_proxy | \`boolean\` | Indicates whether an IP address is coming from a proxy
Ex: true |
| ip\_proxy\_name | \`string\` | When the IP address is a Proxy, indicates the name of the Proxy provider
Ex: Bright Data
Enum: Bright Data, Smartproxy, Oxylabs, Netnut, Webshare, GoProxy |
| ip\_proxy\_type | \`string\` | When the IP address is a Proxy, indicates the type of Proxy
Ex: datacenter
Enum: datacenter, residential |
| ip\_is\_tor | \`boolean\` | Indicates whether an IP address is associated to a TOR node
Ex: true |
| ip\_is\_relay | \`boolean\` | Indicates whether an IP address configured to act as relay
Ex: true |
| ip\_is\_hosting | \`boolean\` | Indicates whether an IP address is a hosting provider
Ex: true |
| ip\_score | \`integer\` | A number ranging from 0 to 1000 represents the quality of the IP information detected
Ex: 649 |
| ip\_score\_cluster | \`string\` | A cluster summarizing the quality of the IP address
Ex: very\_high
Enum: very\_low, low, review, high, very\_high |
| ip\_black\_list\_count | \`integer\` | The number of providers that have flagged this IP as spam
Ex: 5 |
| ip\_company\_domain | \`string\` | The name of the domain of the company that owns the domain, if found
Ex: google.com |
| ip\_company\_name | \`string\` | The name of the company the user works for, contains the full name
Ex: Apple |
| ip\_company\_description | \`string\` | A verbose description description of the company the user works for
Ex: Apple Inc. is an American... |
| ip\_company\_industry | \`string\` | Indicates the industry/sector of the company using a standard taxonomy
Ex: Internet Software & Services |
| ip\_company\_employees | \`integer\` | Indicates the number of employees of the company
Ex: 1750 |
| ip\_company\_founded | \`integer\` | Indicates the year when the company was founded
Ex: 2014 |
| ip\_company\_keywords | \`string\` | A list of keywords used in the company description
Ex: smartphone,tech |
| ip\_company\_annual\_revenue | \`integer\` | Indicates our proprietary estimated annual revenue range for company
Ex: 32500000 |
| ip\_company\_logo | \`string\` | An url linking to the the logo of the company associated to the ip address
Ex: https\://... |
| ip\_company\_country | \`string\` | Indicates the full country name of the company headquarter
Ex: Italy |
| ip\_company\_twitter\_url | \`string\` | Provides a link to the company twitter account, links is always pointing to twitter domain
Ex: https\://... |
| ip\_company\_facebook\_url | \`string\` | Provides the Facebook url of the company, links is always pointing to facebook domain
Ex: https\://... |
| ip\_company\_linkedin\_url | \`string\` | Provides the Linkedin url of the company, links is always pointing to linkedin domain
Ex: https\://... |
| ip\_company\_total\_funding | \`integer\` | Provides the total amount of funding raised by company
Ex: https\://... |
| ip\_company\_tech\_stack | \`string\` | Indicates the set of technologies uses by the company
Ex: JavaScript |
| ip\_reason\_codes | \`string\` | Comma separated risk and trust signal for the product ip.
For more information about reason codes you can go to [Reason Codes]()
Ex: TP001,RP001 |
| ip\_identity\_device\_count | \`integer\` | **DEPRECATED** The number of devices associated with this ip address
Ex: 2 |
| ip\_identity\_email\_count | \`integer\` | The number of email addresses associated with this ip address
Ex: 2 |
| ip\_identity\_msisdn\_count | \`integer\` | The number of phones associated with this ip address
Ex: 2 |
| ip\_identity\_name\_count | \`integer\` | The number of names associated with this ip address
Ex: 2 |
| ip\_remote\_desktop\_enable | \`boolean\` | Indicates if the IP is enabled to accept connections from common remote desktop software
Ex: true |
| ip\_xbl\_count | \`integer\` | The number of times this IP address has been reported in a Exploits Blocklist (XBL)
Ex: 2 |
| ip\_css\_count | \`integer\` | The number of times this IP address has been reported in a Combined Spam Sources (CSS)
Ex: 3 |
| ip\_xbl\_in\_days | \`integer\` | The how many days has passed since the most recent report in a Exploits Blocklist (XBL). Recency indicates more accurate data.
Ex: 2 |
| ip\_css\_in\_days | \`integer\` | The how many days has passed since the most recent report in a Combined Spam Source (CSS). Recency indicates more accurate data.
Ex: 0 |
| ip\_is\_valid\_format | \`boolean\` | Indicates if the IP is in an accepted ipv4 or ipv6 format
Ex: true |
| ip\_is\_private\_internal\_address | \`boolean\` | Indicates if the IP belongs to a private internal address
Ex: true |
> For more information about how to perform an api call you can go to [IP API](https://docs.trustfull.com/reference/ip-api#response-1)