---
title: "Origin IP Address Lookup"
method: GET
path: "/"
tags: ["Ipregistry IP Intelligence API"]
---

# Origin IP Address Lookup

`GET /`

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.

## Query parameters

- `params` object, required

## Response `200`

Successful operation

- RequesterIp — Origin IP address lookup result. Extends the standard IP lookup with the parsed User-Agent of the requester.
  - `ip` string — The IP address that is analyzed.
  - `type` 'IPv4' | 'IPv6' — The IP address version.
  - `hostname` string — The reverse DNS hostname of the IP address, if available.
  - `carrier` Carrier — Mobile carrier information associated with an IP address. Only populated for mobile connections.
    - `name` string — The name of the mobile carrier that owns the IP address.
    - `mcc` string — The Mobile Country Code (MCC) of the carrier, when available.
    - `mnc` string — The Mobile Network Code (MNC) of the carrier, when available.
  - `company` Company — Company information associated with an IP address.
    - `domain` string — The domain associated with the company that owns the IP address.
    - `name` string — The company name associated with the IP address.
    - `type` 'business' | 'education' | 'government' | 'hosting' | 'isp' — The type of company associated with an IP address.
  - `connection` Connection — Network connection information associated with an IP address.
    - `asn` integer — The Autonomous System (AS) Number associated with the IP address.
    - `domain` string — The top-level domain name associated with the organization that owns the connection IP.
    - `is_anycast` boolean — Whether the IP address is announced via anycast, i.e. simultaneously from multiple locations.
    - `organization` string — The name of the organization that owns the Autonomous System for the IP address.
    - `route` string — The AS route associated with the IP address as announced in BGP routing tables.
    - `type` 'business' | 'education' | 'government' | 'hosting' | 'inactive' | 'isp' — The type of network connection.
  - `currency` Currency — Currency information based on the IP address geolocation.
    - `code` string — The ISO 4217 3-letter currency code.
    - `name` string — The name of the currency in US locale.
    - `name_native` string — The name of the currency in native locale based on detected location.
    - `plural` string — The plural name of the currency in US locale.
    - `plural_native` string — The plural name of the currency in native locale.
    - `symbol` string — The symbol of the currency (e.g. A$ for Australian dollars).
    - `symbol_native` string — The native (local) symbol of the currency.
    - `format` CurrencyFormat — Currency formatting rules including separators and prefix/suffix patterns.
      - `decimal_separator` string — The character used as a decimal separator.
      - `group_separator` string — The character used as a thousands group separator.
      - `negative` CurrencyFormatPrefixSuffix — Prefix and suffix pattern for formatting currency amounts.
        - `prefix` string — The string prepended to the currency amount.
        - `suffix` string — The string appended to the currency amount.
      - `positive` CurrencyFormatPrefixSuffix — Prefix and suffix pattern for formatting currency amounts.
        - `prefix` string — The string prepended to the currency amount.
        - `suffix` string — The string appended to the currency amount.
  - `location` Location — Geolocation information for an IP address.
    - `continent` Continent — Continent information.
      - `code` string — The 2-letter continent code.
      - `name` string — The name of the continent.
    - `country` Country — Country information for an IP address location.
      - `area` integer — The sum of land and water areas within international boundaries in km².
      - `borders` string[] — The ISO 3166-1 alpha-2 codes of countries bordering this country.
      - `calling_code` string — The calling/dial code of the country.
      - `capital` string — The capital city of the country.
      - `code` string — The ISO 3166-1 alpha-2 country code.
      - `name` string — The name of the country where the IP address is located.
      - `population` integer — The total population of the country.
      - `population_density` number, double — The number of residents per km² for the country.
      - `flag` Flag — Country flag representations in various formats.
        - `emoji` string — The emoji icon for the flag of the country.
        - `emoji_unicode` string — The unicode value of the emoji icon for the flag.
        - `emojitwo` string — A link to the EmojiTwo SVG file for the country flag.
        - `noto` string — A link to the Noto PNG file for the country flag.
        - `twemoji` string — A link to the Twemoji SVG file for the country flag.
        - `wikimedia` string — A link to the Wikimedia SVG file for the country flag.
      - `languages` Language[] — A list of languages spoken in the country, sorted by popularity.
        - `code` string — The ISO 639-1 or ISO 639-3 language code.
        - `name` string — The name of the language.
        - `native` string — The native name of the language.
      - `tld` string — The country code top-level domain (ccTLD) associated with the country.
    - `region` Region — Region (state, province) information.
      - `code` string — The ISO 3166-2 subdivision/region code.
      - `name` string — The name of the region.
    - `city` string — The name of the city associated with the IP address.
    - `postal` string — The postal/ZIP code associated with the IP address.
    - `latitude` number, double — The approximate WGS84 latitude of the location associated with the IP address.
    - `longitude` number, double — The approximate WGS84 longitude of the location associated with the IP address.
    - `language` Language — Language information.
      - `code` string — The ISO 639-1 or ISO 639-3 language code.
      - `name` string — The name of the language.
      - `native` string — The native name of the language.
    - `in_eu` boolean — Whether the country is a recognized EU member.
  - `security` Security — Security and threat intelligence data for an IP address.
    - `is_abuser` boolean — Whether the IP address is a known source of abuse.
    - `is_attacker` boolean — Whether the IP address is a known source of malicious activity.
    - `is_bogon` boolean — Whether the IP address is an unassigned, unaddressable bogon address.
    - `is_cloud_provider` boolean — Whether the IP address is used for cloud hosting purposes.
    - `is_proxy` boolean — Whether the IP address is a known proxy.
    - `is_relay` boolean — Whether the IP address is a known relay (e.g. Apple Private Relay).
    - `is_tor` boolean — Whether the IP address is a Tor relay node.
    - `is_tor_exit` boolean — Whether the IP address is a Tor exit relay node.
    - `is_vpn` boolean — Whether the IP address is used by a Virtual Private Network.
    - `is_anonymous` boolean — True if is_proxy, is_tor, or is_vpn is true.
    - `is_threat` boolean — True if is_abuser or is_attacker is true.
  - `time_zone` TimeZone — Time zone information based on the IP address geolocation.
    - `id` string — The time zone identifier per IANA Time Zone Database.
    - `abbreviation` string — The abbreviation of the time zone.
    - `current_time` string — The current date and time in ISO 8601 format for the location.
    - `name` string — The name of the time zone.
    - `offset` integer — The GMT offset of the time zone in seconds.
    - `in_daylight_saving` boolean — Whether the time zone currently observes daylight saving time.
  - `user_agent` UserAgent — Parsed User-Agent result containing browser, device, engine, and operating system information.
    - `header` string — The raw User-Agent string extracted from the request.
    - `name` string — The name of the browser.
    - `type` string — The browser classification: browser, browser-webview, cloud-application, email-client, hacker, mobile-app, robot, robot-mobile, special, testclient, or voice.
    - `version` string — The browser version number.
    - `version_major` string — The major version number of the browser.
    - `device` UserAgentDevice — Device information extracted from a User-Agent string.
      - `brand` string — The hardware brand or manufacturer.
      - `name` string — The hardware device name.
      - `type` string — The device classification: anonymized, desktop, ereader, game-console, hacker, handheld-game-console, mobile, phone, robot, robot-imitator, robot-mobile, set-top-box, tablet, tv, virtual-reality, voice, or watch.
    - `engine` UserAgentEngine — Rendering engine information extracted from a User-Agent string.
      - `name` string — The name of the rendering engine.
      - `type` string — The engine classification: browser, mobile-app, hacker, or robot.
      - `version` string — The rendering engine version.
      - `version_major` string — The major version number of the rendering engine.
    - `os` UserAgentOperatingSystem — Operating system information extracted from a User-Agent string.
      - `name` string — The name of the operating system.
      - `type` string — The OS classification: cloud, desktop, embedded, game-console, hacker, or mobile.
      - `version` string — The operating system version.

## Other responses

- `401` — Unauthorized — Missing or disabled API key
- `403` — Forbidden — Invalid API key, insufficient credits, or restricted IP/origin
- `429` — Too many requests — Rate limit exceeded

---

[API](https://skmtc.net/ipregistry/apis/ipregistry-api.md) · [All operations](https://skmtc.net/ipregistry/apis/ipregistry-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ipregistry/ipregistry-api/revisions/26f6ef332981/schema)