IP Detection

Lookup history

Your own past lookups, newest first.

List past lookups

GET/v1/ip/history

API keyNot metered

Parameters

limitintegerquery
Page size, 100 at most.
beforeintegerquery
Return entries older than this id, for paging.
verdictstringquery
Only lookups with this network class.

Response fields

events[].idinteger
Event id, used as the paging cursor.
events[].atstring
When the lookup ran.
events[].targetstring
What was looked up, as sent.
events[].ipstring
IP address that was checked.
events[].verdictstring
residential_clean, mobile, hosting, datacenter, vpn, residential_proxy, tor, relay or unknown.
events[].confidencenumber
Confidence from 0 to 1.
events[].asnstring
Autonomous system number, such as AS15169.
events[].countrystring
Two-letter ISO country code.
events[].sourcestring
api or dashboard.
nextBeforeinteger
Pass as before for the next page; 0 means there is none.
asOfstring
When the response was produced.

curl "https://ipscanner.io/v1/ip/history?limit=2&verdict=vpn" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "events": [
    {
      "id": 48213,
      "at": "2026-10-06T14:02:11Z",
      "target": "198.51.100.23",
      "ip": "198.51.100.23",
      "verdict": "vpn",
      "confidence": 0.92,
      "asn": "AS9009",
      "asnName": "M247 Europe SRL",
      "country": "NL",
      "anonymized": true,
      "source": "api"
    },
    {
      "id": 48177,
      "at": "2026-10-06T13:40:52Z",
      "target": "203.0.113.88",
      "ip": "203.0.113.88",
      "verdict": "vpn",
      "confidence": 0.88,
      "asn": "AS60068",
      "asnName": "Datacamp Limited",
      "country": "GB",
      "anonymized": true,
      "source": "dashboard"
    }
  ],
  "nextBefore": 48177,
  "asOf": "2026-10-06T14:05:00Z"
}