Sign in
latestOpenAPI 3.1.02026-08-1562940.4 KB

26f6ef332981

Ipregistry IP Intelligence API

Origin IP Address Lookup

This endpoint provides details about the initiating IP address, whether it's your own or a website visitor's, without the need for its prior knowledge. Beyond just IP data, it also delivers user-agent specifics which can be utilized to tailor pages or filter users based on the application type, OS, software vendor, and version. This endpoint must be called from a client browser. When called from a server, it returns data for the server's IP. Each lookup consumes 1 credit.

get/

Query parameters

paramsobject required

Parameters from the GET request. If the 'format' query parameter is specified as 'xml', you'll receive the response in XML format.

Response

Successful operation

ipstring

The IP address that is analyzed.

type'IPv4' | 'IPv6'

The IP address version.

hostnamestring

The reverse DNS hostname of the IP address, if available.

Example response

{
  "ip": "8.8.8.8",
  "hostname": "dns.google",
  "carrier": {
    "name": "T-Mobile"
  },
  "company": {
    "domain": "google.com",
    "name": "Google LLC"
  },
  "connection": {
    "asn": 15169,
    "domain": "google.com",
    "organization": "Google LLC",
    "route": "8.8.8.0/24"
  },
  "currency": {
    "code": "USD",
    "name": "US Dollar",
    "name_native": "US Dollar",
    "plural": "US dollars",
    "plural_native": "US dollars",
    "symbol": "$",
    "symbol_native": "$",
    "format": {
      "decimal_separator": ".",
      "group_separator": ",",
      "negative": {
        "prefix": "$"
      },
      "positive": {
        "prefix": "$"
      }
    }
  },
  "location": {
    "continent": {
      "code": "NA",
      "name": "North America"
    },
    "country": {
      "area": 9629091,
      "borders": [
        "CA",
        "MX"
      ],
      "capital": "Washington D.C.",
      "code": "US",
      "name": "United States",
      "population": 340110988,
      "population_density": 35.32,
      "flag": {
        "emoji_unicode": "U+1F1FA U+1F1F8",
        "emojitwo": "https://cdn.ipregistry.co/flags/emojitwo/us.svg",
        "noto": "https://cdn.ipregistry.co/flags/noto/us.png",
        "twemoji": "https://cdn.ipregistry.co/flags/twemoji/us.svg",
        "wikimedia": "https://cdn.ipregistry.co/flags/wikimedia/us.svg"
      },
      "languages": [
        {
          "code": "en",
          "name": "English",
          "native": "English"
        }
      ],
      "tld": ".us"
    },
    "region": {
      "code": "US-CA",
      "name": "California"
    },
    "city": "Mountain View",
    "latitude": 37.40552,
    "longitude": -122.07746,
    "language": {
      "code": "en",
      "name": "English",
      "native": "English"
    }
  },
  "security": {
    "is_cloud_provider": true
  },
  "time_zone": {
    "id": "America/Los_Angeles",
    "abbreviation": "PST",
    "current_time": "2026-02-24T05:51:24-08:00",
    "name": "Pacific Standard Time",
    "offset": -28800
  },
  "user_agent": {
    "header": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
    "name": "Chrome",
    "type": "browser",
    "device": {
      "brand": "Apple",
      "name": "Linux Desktop",
      "type": "desktop"
    },
    "engine": {
      "name": "Blink",
      "type": "browser"
    },
    "os": {
      "name": "Linux",
      "type": "desktop"
    }
  }
}