IP Address

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
webhook_urlThe URL from which the call originated from

Ip Signals

NameTypeDescription
ip_valuestringThe IP address provided during the API call, can either be an ipv4 or ipv6

Ex: 12.34.56.78
ip_citystringThe city associated to the IP address of the customer

Ex: Milan
ip_connection_speedstringInternet 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_typestringUsage 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_countrystringThe 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, ...
ip_ispstringThe service provider used by the customer's device to access the internet

Ex: Fastweb
ip_timezonestringThe exact current time in the Timezone the IP address belongs to

Ex: CET
ip_request_timestringTime of the day the user is requesting your service

Ex: night

Enum: morning, afternoon, evening, night
ip_zipstringThe Postal Code for where the IP Address is located

Ex: 20124
ip_is_mobilebooleanIndicates whether an IP address is associated with a mobile connection

Ex: true
ip_is_vpnbooleanIndicates whether an IP address is under a VPN

Ex: true
ip_vpn_namestringIf the IP address is a VPN, it is the name of the VPN provider

Ex: true
ip_is_proxybooleanIndicates whether an IP address is coming from a proxy

Ex: true
ip_proxy_namestringWhen 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_typestringWhen the IP address is a Proxy, indicates the type of Proxy

Ex: datacenter

Enum: datacenter, residential
ip_is_torbooleanIndicates whether an IP address is associated to a TOR node

Ex: true
ip_is_relaybooleanIndicates whether an IP address configured to act as relay

Ex: true
ip_is_hostingbooleanIndicates whether an IP address is a hosting provider

Ex: true
ip_scoreintegerA number ranging from 0 to 1000 represents the quality of the IP information detected

Ex: 649
ip_score_clusterstringA cluster summarizing the quality of the IP address

Ex: very_high

Enum: very_low, low, review, high, very_high
ip_black_list_countintegerThe number of providers that have flagged this IP as spam

Ex: 5
ip_company_domainstringThe name of the domain of the company that owns the domain, if found

Ex: google.com
ip_company_namestringThe name of the company the user works for, contains the full name

Ex: Apple
ip_company_descriptionstringA verbose description description of the company the user works for

Ex: Apple Inc. is an American...
ip_company_industrystringIndicates the industry/sector of the company using a standard taxonomy

Ex: Internet Software & Services
ip_company_employeesintegerIndicates the number of employees of the company

Ex: 1750
ip_company_foundedintegerIndicates the year when the company was founded

Ex: 2014
ip_company_keywordsstringA list of keywords used in the company description

Ex: smartphone,tech
ip_company_annual_revenueintegerIndicates our proprietary estimated annual revenue range for company

Ex: 32500000
ip_company_logostringAn url linking to the the logo of the company associated to the ip address

Ex: https://...
ip_company_countrystringIndicates the full country name of the company headquarter

Ex: Italy
ip_company_twitter_urlstringProvides a link to the company twitter account, links is always pointing to twitter domain

Ex: https://...
ip_company_facebook_urlstringProvides the Facebook url of the company, links is always pointing to facebook domain

Ex: https://...
ip_company_linkedin_urlstringProvides the Linkedin url of the company, links is always pointing to linkedin domain

Ex: https://...
ip_company_total_fundingintegerProvides the total amount of funding raised by company

Ex: https://...
ip_company_tech_stackstringIndicates the set of technologies uses by the company

Ex: JavaScript
ip_reason_codesstringComma 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_countintegerThe number of devices associated with this ip address

Ex: 2
ip_identity_email_countintegerThe number of email addresses associated with this ip address

Ex: 2
ip_identity_msisdn_countintegerThe number of phones associated with this ip address

Ex: 2
ip_identity_name_countintegerThe number of names associated with this ip address

Ex: 2
ip_remote_desktop_enablebooleanIndicates if the IP is enabled to accept connections from common remote desktop software

Ex: true
ip_xbl_countintegerThe number of times this IP address has been reported in a Exploits Blocklist (XBL)

Ex: 2
ip_css_countintegerThe number of times this IP address has been reported in a Combined Spam Sources (CSS)

Ex: 3
ip_xbl_in_daysintegerThe 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_daysintegerThe how many days has passed since the most recent report in a Exploits Blocklist (XBL). Recency indicates more accurate data.

Ex: 0
ip_is_valid_formatbooleanIndicates if the IP is in an accepted ipv4 or ipv6 format

Ex: true

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