Advanced IP verification, enrichment, and score

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",
      "score": 649,
      "score_cluster": "good"      
   }
}

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

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:

  • poor
  • bad
  • moderate
  • good
  • high
Language
Authentication
Header
Click Try It! to start a request and see the response here!