Fido IP

Fido's API endpoints are quite flexible and you can request a range of services from a single endpoint

One of the possible use cases is Fido IP

What is Fido IP?

Fido IP is the product that combines IP address validation, enrichment and scoring

Request

following an example of a Fido IP

curl --request POST \
     --url https://api.fido.id/1.0/ip \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'x-api-key: [your_app_key]' \
     --data '
{
     "customer_id": "c426ad68-8987-11ec-a8a3-0242ac120002",
     "claims": [
          "ip"
     ],
     "ip": "88.149.202.248",
}'

Response

Following an example of the response:

{
   "resolution_id":"...",
   "customer_id":"...",
   "device_request_time":"...",
   "claims":[
      "ip"
   ],
   "ip":{
      "value":"88.149.202.248",
      "city":"Mountain View",
      "connection_speed":"T1",
      "connection_type":"Data Center / Web Hosting / Transit",
      "country":"US",
      "isp":"Google LLC",
      "timezone":"America/Los_Angeles",
      "request_time":"morning",
      "zip":"94043",
      "is_mobile":true,
      "is_vpn":true,
      "vpn_name":"VPN Provider",
      "is_proxy":true,
      "is_tor":true,
      "is_relay":true,
      "is_hosting":true,
      "black_list_count":true,
      "company_domain":"domain.com",
      "company_name":"Google",
      "company_description":"Company description",
      "company_country":"US",
      "company_facebook_url":"https://facebook.com/company",
      "company_linkedin_url":"https://linkedin.com/company",
      "company_twitter_url":"https://twitter.com/company",
      "company_industry":"information technology & services",
      "company_employees":100000,
      "company_founded":1991,
      "company_annual_revenue":2000000,
      "company_total_funding":20000000,
      "company_tech_stack":"Route 53,Gmail,Google Apps,Amazon AWS,Apache,Mobile Friendly,WordPress.org,Nginx,Google Tag Manager,Google Font API",
      "company_keywords":"regtech,identity verification,kyc,aml,credit scoring,online fraud prevention",
      "company_logo":"https://zenprospect-production.s3.amazonaws.com/uploads/pictures/614ebaff41b79d00012fd54b/picture""score":649,
      "score_cluster":"high"
   }
}

RESPONSE

The following fields can be found under the "ip" object

name	type
value	string The IP address provided during the API call ex: 127.0.0.1
city	string The city associated to the IP address of the customer. ex: Milan
connection_type	string Usage type classification of ISP or company ex : (COM) Commercial (ORG) Organization (GOV) Government (MIL) Military (EDU) University/College/School (LIB) Library (CDN) Content Delivery Network (ISP) Fixed Line ISP (MOB) Mobile ISP (DCH) Data Center/Web Hosting/Transit (SES) Search Engine Spider (RSV) Reserved
connection_speed	string Internet connection type ex: - dial up - broadband/cable/fiber/mobile - company/T1
country	string The name of the country where the IP Address is located, ISO 3166 ex: UK
isp	string The service provider used by the customer's device to access the internet. ex: Fastweb
timezone	string The exact current time in the Timezone the IP address belongs to. ex: CET
request_time	string Time of the day the user is requesting your service ex: morning, afternoon, evening, night
zip	string The Postal Code for where the IP Address is located ex: 20124
is_mobile	boolean Indicates whether an IP address is mobile ex: true
is_vpn	boolean Indicates whether an IP address is a VPN ex: true
vpn_name	string If the IP address is a VPN, it is the name of the VPN provider ex: NordVPN
is_proxy	boolean Indicates whether an IP address is a proxy ex: true
is_tor	boolean Indicates whether an IP address is a TOR node ex: true
is_relay	boolean Indicates whether an IP address is a relay ex: true
is_hosting	boolean Indicates whether an IP address is a hosting provider ex: true
black_list_count	number The number of providers that have flagged this IP as spam ex: 3
company_domain	?string The name of the domain of the company that owns the domain, if found ex: google.com
company_name	?string The name of the company that owns the domain, if found ex: Google
company_description	?string The description of the company that owns the domain, if found ex: A company description
company_country	?string The country of the company that owns the domain, if found ex: Italy
company_facebook_url	?string The facebook page of the company that owns the domain, if found ex: https://facebook.com/company
company_linkedin_url	?string The linkedin page of the company that owns the domain, if found ex: https://linkedin.com/company
company_twitter_url	?string The twitter page of the company that owns the domain, if found ex: https://facebook.com/company
company_industry	?string The target industry of the company that owns the IP ex: information technology & services
company_employees	?number The number of employees of the company that owns the IP ex: 10000
company_founded	?number Year of foundation of the company that owns the IP ex: 1991
company_annual_revenue	?number The annual revenue of the company that owns the IP ex: 100000
company_total_funding	?number The total funding of the company that owns the IP ex: 1000000
company_tech_stack	?string The tech stack of the company that owns the IP ex: Route 53,Gmail,Google Apps,Amazon AWS,Apache,Mobile Friendly,WordPress.org,Nginx,Google Tag Manager,Google Font API
company_keywords	?string The keywords of the company that owns the IP ex: regtech,identity verification,kyc,aml,credit scoring,online fraud prevention
company_logo	?string The logo URL of the company that owns the IP ex: https://zenprospect-production.s3.amazonaws.com/uploads/pictures/614ebaff41b79d00012fd54b/picture
score	number A number ranging from 0 to 1000 represents the quality of the IP information detected ex: 649
score_cluster	string A cluster summarizing the quality of the IP information detected ex: very_low, low, review, high, very_high