IP Shield

IP Shield

Overview

Lookup IP API

Standard IP data lookup

The Lookup IP API provides a intelligence profile for any IP address. The endpoint returns geographic data, network carrier metadata, and core risk indicators including proxy, VPN, and Tor usage. Use this endpoint to assess visitor risk and localize content.

Endpoint

Terminal
curl -X GET "https://ip-shield.riavzon.com/api/v1/lookup/ip/93.184.216.34" \
  -H "x-api-key: YOUR_API_KEY"

The 93.184.216.34 parameter in the URL path represents the target IPv4 or IPv6 address you want to look up.

Response Example

HTTP/1.1 200 OK
Content-Type: application/json

{
  "ok": true,
  "date": "2025-06-12T00:00:00.000Z",
  "data": {
    "ip": "93.184.216.34",
    "location": {
      "country": "United States",
      "country_code": "US",
      "region": "Massachusetts",
      "city": "Norwell",
      "language_iso639": "en-US",
      "timezone": "America/New_York",
      "latitude": "42.1615",
      "longitude": "-70.7928"
    },
    "proxy": false,
    "vpn": false,
    "threat_level": 0,
    "is_known_bot": false,
    "tor": false,
    "network": {
      "asn_id": "15133",
      "asn_name": "EDGECAST",
      "classification": "hosting"
    }
  },
  "meta": {
    "total_credits": 10000,
    "credits_remaining": 9999
  }
}

Response Fields

ok
boolean
Indicates whether the request was successful (true).
date
string
ISO 8601 timestamp of when the response was generated.
data.ip
string
The IP address that was queried.
data.location.country
string
The full name of the country.
data.location.country_code
string
Two-letter ISO 3166-1 alpha-2 country code.
data.location.region
string
The primary administrative division (e.g., state or province).
data.location.city
string
The city where the IP is located.
data.location.language_iso639
string
Primary language spoken, in ISO 639 format.
data.location.timezone
string
The IANA timezone database name (e.g., America/New_York).
data.location.latitude
string
Estimated latitude coordinate.
data.location.longitude
string
Estimated longitude coordinate.
data.proxy
boolean
true if the IP is acting as a generic proxy.
data.vpn
boolean
true if the IP belongs to a Virtual Private Network.
data.threat_level
number
A score indicating the historical risk of the IP (higher is riskier).
data.is_known_bot
boolean
true if the IP is associated with a known crawler such as googlebot.
data.tor
boolean
true if the IP is part of the Tor anonymity network.
data.network.asn_id
string
The Autonomous System Number (ASN) assigned to the routing provider.
data.network.asn_name
string
The name of the Autonomous System organization.
data.network.classification
string
The network type classification (hosting, eyeballs, unknown).
meta.total_credits
number
The total number of credits allocated to your account's plan.
meta.credits_remaining
number
The number of credits remaining in your current billing cycle.

Error Response

Error responses, such as bad requests or rate limits, return the following JSON format.

HTTP/1.1 400 Bad Request
Content-Type: application/json

{
  "ok": false,
  "date": "2025-06-12T00:00:00.000Z",
  "reason": "Invalid IP address format"
}

Error Fields

ok
boolean
Always false for error responses.
date
string
ISO 8601 timestamp of when the error occurred.
reason
string
A human-readable message explaining why the request failed.

Geo Check API

Network API

Logo