IP Shield

IP Shield

Overview

Geo Check API

Check geographic location

The Geo Check API provides granular, city-level geographic mapping for an IPv4 or IPv6 address. It utilizes geofeeds and enriched RIR datasets to return accurate location context, enabling you to localize user experiences, enforce geo-blocking, and adapt pricing automatically.

Endpoint

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

The 8.8.8.8 parameter in the URL path represents the target IPv4 or IPv6 address you want to check.

Response Example

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

{
  "ok": true,
  "date": "2025-06-12T00:00:00.000Z",
  "data": {
    "ip": "8.8.8.8",
    "country_code": "US",
    "region": "California",
    "continent": "North America",
    "country": "United States",
    "city": "Mountain View",
    "capital": "Washington D.C.",
    "subregion": "Northern America",
    "zip_code": "94035",
    "latitude": "37.3860",
    "longitude": "-122.0838",
    "state": "California",
    "nationality": "American",
    "phone": "+1",
    "currency": "USD",
    "currency_name": "United States Dollar",
    "currency_symbol": "$",
    "language_iso639": "en-US",
    "tld": ".us",
    "utc_offset": "-0700",
    "timezone": "America/Los_Angeles",
    "timeZoneName": "Pacific Daylight Time"
  },
  "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.country_code
string
Two-letter ISO 3166-1 alpha-2 country code.
data.region
string
The primary administrative division (e.g., state or province).
data.continent
string
The continent where the IP is located.
data.country
string
The full name of the country.
data.city
string
The city where the IP is located.
data.capital
string
The capital city of the country.
data.subregion
string
The broader geographical subregion.
data.zip_code
string
The postal or zip code of the location.
data.latitude
string
Estimated latitude coordinate.
data.longitude
string
Estimated longitude coordinate.
data.state
string
Alias for region or specific state name.
data.nationality
string
The nationality demonym of the country.
data.phone
string
The international calling code prefix.
data.currency
string
Three-letter ISO 4217 currency code.
data.currency_name
string
The full name of the local currency.
data.currency_symbol
string
The local currency symbol.
data.language_iso639
string
Primary language spoken, in ISO 639 format.
data.tld
string
The country code top-level domain.
data.utc_offset
string
The current UTC time offset of the location.
data.timezone
string
The IANA timezone database name (e.g., America/Los_Angeles).
data.timeZoneName
string
The human-readable name of the timezone.
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.

Email Domain Check API

Lookup IP API

Logo