1. Home
  2. Docs
  3. Options
  4. Request parameters

Request parameters

ClarifyIP’s primary endpoint is used to look up single IPv4 or IPv6 addresses. To call this endpoint, simply attach any IPv4 or IPv6 address to the API’s base URL.

API Request:

https://api.clarifyip.com/?key=YOUR_ACCESS_KEY&ip=185.245.87.169

Request Parameters:

Parameter Value
key [required] Access key. Sign up to run API Requests.
ip [optional] Any IPv4 or IPv6 address. If not provided, the ClarifyIP API will use a requester’s IP address
callback [optional] Specify a JSONP callback function name according to the JSONP Callbacks section.
output [optional] The output type of the response. Set it to json or xml. (json is a default)
more [optional] Set to user to check your account limits – it will append a user node with number of requests and your limit.
code [optional] Return response in a different code language. Available options are: en, ru, fr, pt-BR, zh-CN, es, de and ja. Read more.

API Response:

{  
   "connection":{  
      "asn":9009,
      "ip":"185.245.87.169",
      "isp":"M247 Ltd",
      "type":"ipv4"
   },
   "zip":"90014",
   "city":{  
      "name":"Los Angeles",
      "id":5368361
   },
   "location":{  
      "metro_code":34.0494,
      "languages":[  
         "eng"
      ],
      "calling_code":[  
         "+1"
      ],
      "flag":"//cdn.clarifyip.com/assets/flags/svg/us.svg",
      "emoji":"??",
      "latitude":34.0494,
      "longitude":-118.2641
   },
   "country":{  
      "code_3":"USA",
      "name":"United States",
      "id":6252001,
      "code":"US"
   },
   "region":{  
      "code":"CA",
      "name":"California"
   },
   "continent":{  
      "name":"North America",
      "id":6255149,
      "code":"NA"
   },
   "time_zone":{  
      "id":"America/Los_Angeles"
   }
}
Was this article helpful to you? Yes No

How can we help?