--- title: "Single or Batch ASN/IP Address Lookup" method: GET path: "/{asnOrIps}/" tags: ["Ipregistry IP Intelligence API"] --- # Single or Batch ASN/IP Address Lookup `GET /{asnOrIps}/` This endpoint is suitable for individual and batch ASN/IP queries. To access it, add an ASN or IP address to the API's base URL using the HTTP GET method, which uses one credit. For batch processing, attach several ASNs or IP addresses to the API's base URL, separated by commas, through the HTTP GET method. You can combine up to 16 ASNs and 1024 IP addresses in a batch. For such batch queries, the credit charge is the total of the provided ASN and IP addresses, plus an additional credit. ## Path parameters - `asnOrIps` string, required ## Query parameters - `params` object, required ## Response `200` Successful operation - union — This can be either an ASN, an IP address, or a BatchLookupResult object. - AutonomousSystem — Autonomous System (AS) lookup result containing allocation details, network prefixes, and peering relationships. - `allocated` string, date-time — The date and time when the Autonomous System was allocated, in ISO 8601 format. - `asn` integer — The Autonomous System Number (ASN) that uniquely identifies an Autonomous System on the Internet. - `country_code` string — The country in which the resource holder is legally based, in ISO 3166-1 alpha-2 format. - `domain` string — The top-level domain name associated with the Autonomous System. - `name` string — The name of the organization that owns the Autonomous System. - `prefixes` AutonomousSystemPrefixes — IPv4 and IPv6 network prefixes announced by an Autonomous System. - `ipv4_count` integer — The total number of IPv4 addresses announced by the Autonomous System. - `ipv6_count` integer — The total number of IPv6 addresses announced by the Autonomous System. - `ipv4` AutonomousSystemPrefix[] — The list of IPv4 prefixes announced by the Autonomous System. - `cidr` string — The Classless Inter-Domain Routing notation representing a specific IP address block. - `country_code` string — The two-letter country code representing the legal location for the IP address block. - `network_name` string — A descriptive name as it appears in Whois. - `organization` string — A short name or description of the organization that uses the prefix. - `registry` 'AFRINIC' | 'APNIC' | 'ARIN' | 'JPNIC' | 'KRNIC' | 'LACNIC' | 'RIPE_NCC' | 'TWNIC' — The Regional Internet Registry responsible for allocating and registering the IP prefix. - `status` string — The current assignment status of the IP address block. - `size` number — The total number of IP addresses contained within the CIDR block. - `ipv6` AutonomousSystemPrefix[] — The list of IPv6 prefixes announced by the Autonomous System. - `cidr` string — The Classless Inter-Domain Routing notation representing a specific IP address block. - `country_code` string — The two-letter country code representing the legal location for the IP address block. - `network_name` string — A descriptive name as it appears in Whois. - `organization` string — A short name or description of the organization that uses the prefix. - `registry` 'AFRINIC' | 'APNIC' | 'ARIN' | 'JPNIC' | 'KRNIC' | 'LACNIC' | 'RIPE_NCC' | 'TWNIC' — The Regional Internet Registry responsible for allocating and registering the IP prefix. - `status` string — The current assignment status of the IP address block. - `size` number — The total number of IP addresses contained within the CIDR block. - `relationships` AutonomousSystemRelationships — BGP peering relationships for an Autonomous System. - `downstreams` integer[] — A list of ASNs that primarily receive their Internet traffic from this Autonomous System. - `peers` integer[] — A list of ASNs that maintain a mutual agreement with this AS to exchange traffic directly. - `upstreams` integer[] — A list of ASNs from which this Autonomous System primarily receives its internet traffic. - `registry` 'AFRINIC' | 'APNIC' | 'ARIN' | 'JPNIC' | 'KRNIC' | 'LACNIC' | 'RIPE_NCC' | 'TWNIC' — The Regional Internet Registry to which the Autonomous System is registered. - `type` 'business' | 'education' | 'government' | 'hosting' | 'inactive' | 'isp' — The AS usage type: business, education, government, hosting, inactive, or isp. - `updated` string, date-time — The date and time when the Autonomous System record was last updated, in ISO 8601 format. - Ip — IP address lookup result containing geolocation, company, carrier, connection, currency, security, and time zone data. - `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. - BatchLookupResult — Batch lookup result containing an array of IP and/or ASN lookup results. - `results` unknown[] — An array of lookup results. Each entry is either an IP lookup result, an ASN lookup result, or an error object if the individual lookup failed. - unknown ## Other responses - `400` — Bad request — Invalid ASN, IP address, or too many items - `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)