Skip to main content
IPinfo logo
  • Category: developer tools
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 27
  • Triggers: 0
  • Slug: IPINFO_IO
  • Version: 20261101_00
  • Instant: Supported on the latest version. Support varies by tool.

Tools

Slug: IPINFO_IO_BATCH_LITE_LOOKUPPerform bulk Lite IP lookups for up to 1000 IPs in a single request. Returns lightweight IP information including ASN (Autonomous System Number), AS organization details, and geolocation (country and continent). Use cases: - Look up geolocation for multiple IPs at once - Identify the ISP/organization owning IP addresses - Detect bogon/private IPs (192.168.x.x, 10.x.x.x, etc.) - Retrieve specific fields only (e.g., ‘8.8.8.8/country’ returns just the country) Supports both IPv4 and IPv6 addresses.

Input Parameters

array
required
List of 1-1000 IP addresses or IP/field paths to look up. Supports IPv4 (e.g., ‘8.8.8.8’), IPv6 (e.g., ‘2001:4860:4860::8888’), and subfield queries (e.g., ‘8.8.8.8/country’, ‘8.8.8.8/asn’). Available subfields: asn, as_name, as_domain, country_code, country, continent_code, continent.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_BATCH_LOOKUPPerform batch IP lookups to retrieve geolocation and ASN information for multiple IPs in a single request. Use this tool when you need to look up multiple IP addresses efficiently. Supports up to 1000 IPs per request. IMPORTANT: For free tier API tokens, prefix each IP with ‘lite/’ (e.g., ‘lite/8.8.8.8’). Bare IPs without the ‘lite/’ prefix require a paid subscription. Managed execution accepts 1 to 1000 distinct bare IPv4/IPv6 addresses only. Each submitted IP counts as one lookup, including entries omitted by filtering.Instant: Supported on the latest version.Instant pricing: $0.002 per 10 IP lookups; each submitted IP counts as one lookup

Input Parameters

array
required
List of 1 to 1000 IP addresses. Managed execution accepts only distinct bare IPv4 or IPv6 addresses, with one lookup charged per entry. BYOK also supports URL patterns. For free tier tokens, prefix IPs with ‘lite/’ (e.g., ‘lite/8.8.8.8’). Supports field extraction patterns like ‘lite/8.8.8.8/country’ or ‘lite/8.8.8.8/asn’. IPv4 and IPv6 addresses are both supported.
boolean
When True, entries with null responses are omitted from results. Useful for filtering out invalid IPs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_GET_ABUSE_CONTACTRetrieve abuse contact or basic organization information for an IP address. When abuse details are unavailable, a fallback may return only available basic information or an empty abuse object.

Input Parameters

string
required
IPv4 or IPv6 address to look up (e.g., ‘8.8.8.8’ or ‘2001:4860:4860::8888’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_GET_CARRIER_INFORetrieve mobile carrier information for an IP address, including carrier name, MCC and MNC when available. If carrier details are unavailable, a Lite fallback may return an ASN organization name or Unknown with empty codes.

Input Parameters

string
required
The IP address to look up carrier information for. Accepts IPv4 (e.g., ‘8.8.8.8’) or IPv6 (e.g., ‘2001:4860:4860::8888’) addresses.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_GET_CITY_BY_IPRetrieve the city name for a specific IP address. Returns the city name as plain text for any IPv4 or IPv6 address.Instant: Supported on the latest version.Instant pricing: $0.002 per 10 IP lookups

Input Parameters

string
required
A single IPv4 or IPv6 IP address to retrieve the city name for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_GET_COMPANY_INFORetrieve company information for an IPv4 or IPv6 address, including name, domain and type. For certain company-permission errors, a Lite fallback may instead return ASN-derived details with an unknown type.

Input Parameters

string
required
The IPv4 or IPv6 address to retrieve company information for
string
Optional API token override. Usually not needed as the token is auto-injected from credentials.
string
JSONP callback function name (rarely needed for agent use cases).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_GET_CORE_FIELD_BY_MERetrieve a supported field about the current IP, such as city, country, hostname, or the combined AS organization field, instead of the complete IP profile. Some accepted field choices are unavailable and cause an error.

Input Parameters

string ("ip" | "hostname" | "geo" | "geo/city" | "geo/region" | "geo/region_code" | "geo/country" | "geo/country_code" | "geo/continent" | "geo/continent_code" | "geo/latitude" | "geo/longitude" | "geo/timezone" | "geo/postal_code" | "as" | "as/asn" | "as/name" | "as/domain" | "as/type" | "is_anonymous" | "is_anycast" | "is_hosting" | "is_mobile" | "is_satellite")
required
A specific field from the core response or nested geo/as fields. For example: ‘ip’, ‘hostname’, ‘geo/city’, ‘geo/country’, ‘as/asn’, etc.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_GET_COUNTRY_BY_IPRetrieve the two-letter ISO 3166 country code for an IP address. Use when you need to quickly identify which country an IP address is located in without requesting full geolocation details.Instant: Supported on the latest version.Instant pricing: $0.002 per 10 IP lookups

Input Parameters

string
required
A single IPv4 or IPv6 IP address to retrieve country information for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_GET_CURRENT_IPRetrieve the current public/external IP address. Use this tool when you need to determine the caller’s public IP address.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_GET_CURRENT_IP_INFORetrieve information about the caller’s current IP address without specifying an IP. Depending on availability, results may include geolocation, ASN, company, privacy and mobile carrier details.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_GET_CURRENT_LOCRetrieve geographic coordinates for the current IP address. Returns the latitude and longitude of the caller’s IP address as a comma-separated string in the format ‘latitude,longitude’. Use this when you need quick location coordinates without full geolocation details.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_GET_CURRENT_REGIONRetrieve the region/state for the caller’s current IP address. Use this tool when you need to identify the geographic region or state where the current IP address is located. Returns a plain text region name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_GET_GEO_BY_IPGet geolocation and basic IP details for an IPv4 or IPv6 address. Returns available city, region, country, approximate coordinates, timezone and postal data. Legacy responses use loc for latitude,longitude and postal for the postal code, and may include ip, hostname and ASN organization. Additional geographic fields depend on the provider response and subscription.Instant: Supported on the latest version.Instant pricing: $0.002 per 10 IP lookups

Input Parameters

string
required
IPv4 or IPv6 address to look up for geolocation data

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_GET_HOSTNAME_BY_IPRetrieve the hostname (reverse DNS) for an IP address. Use this tool to look up the hostname associated with any IPv4 or IPv6 address. Returns the hostname as a string. If no hostname is available, returns an empty string.Instant: Supported on the latest version.Instant pricing: $0.002 per 10 IP lookups

Input Parameters

string
required
A single IPv4 or IPv6 IP address to look up hostname for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_GET_IP_BY_IPRetrieve the IP address for a specified IP as plain text. Use this tool to echo back an IP address from the IPInfo API. This endpoint returns the IP address as plain text (not JSON). Useful for verifying IP address formatting or testing connectivity.Instant: Supported on the latest version.Instant pricing: $0.002 per 10 IP lookups

Input Parameters

string
required
A single IPv4 or IPv6 IP address to query.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_GET_IP_INFORetrieve geolocation and ASN information for an IP address. Use this tool to look up country, continent, and Autonomous System (AS) details for any IPv4 or IPv6 address. Pass ‘me’ or omit the ip parameter to get information about the caller’s own IP address. For private/reserved (bogon) IP addresses like 192.168.x.x or 10.x.x.x, only the ip and bogon fields will be populated.

Input Parameters

string
IP address to look up (IPv4 or IPv6) or ‘me’ for the caller’s IP. Defaults to ‘me’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_GET_IP_INFO_BY_IPRetrieve available IP information for a specified IPv4 or IPv6 address. Core data includes geographic location, ASN organization information and available connection flags. Coordinates are approximate. Detailed company, carrier, VPN/proxy/Tor service and hosted-domain data require the relevant richer provider subscription and are not guaranteed by Core. Missing optional fields do not mean the corresponding network characteristic is false.Instant: Supported on the latest version.Instant pricing: $0.002 per 10 IP lookups

Input Parameters

string
required
A single IPv4 or IPv6 IP address to look up

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_GET_LITE_FIELD_BY_IPRetrieve a specific field from lightweight IP information. Use this tool to get a single piece of information about an IP address (e.g., just the country, or just the ASN) without fetching the full IP data. This is more efficient when you only need one specific field. Supported fields: ip, asn, as_name, as_domain, country_code, country, continent_code, continent.

Input Parameters

string
required
A single IPv4 or IPv6 IP address to look up.
string ("ip" | "asn" | "as_name" | "as_domain" | "country_code" | "country" | "continent_code" | "continent")
required
The specific field to retrieve from the lite response. Supported fields: ip, asn, as_name, as_domain, country_code, country, continent_code, continent.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_GET_LOCATION_BY_IPRetrieve geographic coordinates (latitude, longitude) for an IP address. Returns location as comma-separated text in the format ‘latitude,longitude’. Use when you need precise geolocation coordinates for IPv4 or IPv6 addresses.Instant: Supported on the latest version.Instant pricing: $0.002 per 10 IP lookups

Input Parameters

string
required
A single IPv4 or IPv6 IP address to get location coordinates for (e.g., ‘8.8.8.8’ or ‘2001:4860:4860::8888’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_GET_ORG_BY_IPRetrieve ASN and organization name for an IP address as plain text. Use this tool when you need to quickly identify which organization or ASN owns a specific IP address. Returns a plain text string containing the Autonomous System Number (ASN) and organization name (e.g., ‘AS15169 Google LLC’).Instant: Supported on the latest version.Instant pricing: $0.002 per 10 IP lookups

Input Parameters

string
required
A single IPv4 or IPv6 IP address to look up organization information for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_GET_PLUS_FIELD_BY_MERetrieve a selected IPinfo Plus field for the calling IP address, such as geographic, autonomous system, mobile carrier, or privacy information. Access to Plus information may require an appropriate subscription.

Input Parameters

string ("ip" | "geo" | "geo/city" | "geo/region" | "geo/region_code" | "geo/country" | "geo/country_code" | "geo/continent" | "geo/continent_code" | "geo/latitude" | "geo/longitude" | "geo/timezone" | "geo/postal_code" | "geo/dma_code" | "geo/geoname_id" | "geo/radius" | "geo/last_changed" | "as" | "as/asn" | "as/name" | "as/domain" | "as/type" | "as/last_changed" | "mobile" | "mobile/name" | "mobile/mcc" | "mobile/mnc" | "anonymous" | "anonymous/name" | "anonymous/is_proxy" | "anonymous/is_relay" | "anonymous/is_tor" | "anonymous/is_vpn" | "is_anonymous" | "is_anycast" | "is_hosting" | "is_mobile" | "is_satellite")
required
A specific field from the plus response or nested geo/as/mobile/anonymous fields. For example, ‘ip’, ‘geo/city’, ‘as/asn’, ‘mobile/name’, or ‘is_anonymous’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_GET_POSTAL_BY_IPRetrieve the postal/zip code for an IP address. Use this when you need to identify the geographic postal code associated with an IPv4 or IPv6 address.Instant: Supported on the latest version.Instant pricing: $0.002 per 10 IP lookups

Input Parameters

string
required
A single IPv4 or IPv6 IP address to look up the postal/zip code for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_GET_PRIVACY_DETAILSRetrieve VPN, proxy, Tor, relay and hosting privacy flags for an IP address. Missing flags default to false, and after a 401 or 403 all flags default to false only if a basic lookup succeeds; these defaults do not establish that the IP lacks those characteristics.

Input Parameters

string
required
IPv4 or IPv6 address to look up for privacy detection

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_GET_REGION_BY_IPRetrieve the region/state for a specified IP address. Use this tool when you need to identify the geographic region or state where a specific IPv4 or IPv6 address is located. Returns a plain text region name.Instant: Supported on the latest version.Instant pricing: $0.002 per 10 IP lookups

Input Parameters

string
required
A single IPv4 or IPv6 IP address to retrieve the region/state for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_GET_TIMEZONE_BY_IPRetrieve the IANA timezone for a given IP address. Use this tool when you need to determine the local timezone of an IP address location for scheduling, time conversion, or geographic analysis purposes.Instant: Supported on the latest version.Instant pricing: $0.002 per 10 IP lookups

Input Parameters

string
required
IPv4 or IPv6 address to look up timezone for (e.g., ‘8.8.8.8’ or ‘2001:4860:4860::8888’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_GET_TOKEN_INFORetrieve API service request limit information by access token. Returns usage statistics, request limits, remaining quota, and available API features. Use this to check your token’s rate limits, current usage, and feature access before making other API calls.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: IPINFO_IO_MAP_IPSCreate an IPinfo map visualization from a list of IP addresses. Use this tool to generate an interactive map showing the geographic locations of multiple IP addresses. The tool accepts up to 500,000 IPs and returns a link to a visual map where all IP locations are plotted. Useful for visualizing the geographic distribution of network traffic, analyzing user locations, or investigating security incidents across multiple IP addresses.

Input Parameters

integer
Optional CLI flag parameter for API compatibility. Set to 1 to enable CLI mode.
array
required
List of IP addresses to plot on a map. Supports both IPv4 and IPv6 addresses. Maximum 500,000 IPs per request. Each IP will be geolocated and displayed on an interactive map.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not