# Ipinfo.io

IPinfo.io provides a comprehensive API for IP address geolocation and related data.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 27
- **Triggers:** 0
- **Slug:** `IPINFO_IO`
- **Version:** 20260312_00

## Tools

### Batch Lite Lookup

**Slug:** `IPINFO_IO_BATCH_LITE_LOOKUP`

Perform 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `queries` | array | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Batch IP Lookup

**Slug:** `IPINFO_IO_BATCH_LOOKUP`

Perform 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ips` | array | Yes | List of up to 1000 IP addresses or 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. |
| `filter` | boolean | No | When True, entries with null responses are omitted from results. Useful for filtering out invalid IPs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Abuse Contact

**Slug:** `IPINFO_IO_GET_ABUSE_CONTACT`

Retrieve abuse contact and organization information for an IP address. Use this tool when you need to identify who owns an IP address or find contact information for reporting malicious activity. Note: Full abuse contact details (email, phone, name) require IPinfo Enterprise tier. For standard tiers, returns organization info (org, country, city, region) which can be used to identify the IP owner.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | IPv4 or IPv6 address to look up (e.g., '8.8.8.8' or '2001:4860:4860::8888') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get IP Carrier Info

**Slug:** `IPINFO_IO_GET_CARRIER_INFO`

Retrieves mobile carrier information for a given IP address. Returns the carrier name, Mobile Country Code (MCC), and Mobile Network Code (MNC) for mobile network IPs. For non-mobile IPs (e.g., datacenter, ISP), returns the organization/ASN name with empty MCC/MNC values. Useful for identifying if an IP belongs to a mobile carrier network and which carrier it is.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get City by IP

**Slug:** `IPINFO_IO_GET_CITY_BY_IP`

Retrieve the city name for a specific IP address. Returns the city name as plain text for any IPv4 or IPv6 address.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | A single IPv4 or IPv6 IP address to retrieve the city name for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Company Info for an IP

**Slug:** `IPINFO_IO_GET_COMPANY_INFO`

Retrieve company/organization information for an IP address. Returns the company name, domain, and type (business, ISP, hosting, etc.) associated with the IP. Supports both IPv4 and IPv6 addresses.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | The IPv4 or IPv6 address to retrieve company information for |
| `token` | string | No | Optional API token override. Usually not needed as the token is auto-injected from credentials. |
| `callback` | string | No | JSONP callback function name (rarely needed for agent use cases). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Core Field by Me

**Slug:** `IPINFO_IO_GET_CORE_FIELD_BY_ME`

Retrieve a specific field from core IP information about the current IP. Use this tool when you need just one specific piece of information (like city, country, hostname, or AS details) about the caller's IP address instead of fetching the complete IP profile.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `field` | 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") | Yes | A specific field from the core response or nested geo/as fields. For example: 'ip', 'hostname', 'geo/city', 'geo/country', 'as/asn', etc. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Country by IP

**Slug:** `IPINFO_IO_GET_COUNTRY_BY_IP`

Retrieve 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | A single IPv4 or IPv6 IP address to retrieve country information for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Current IP

**Slug:** `IPINFO_IO_GET_CURRENT_IP`

Retrieve the current public/external IP address. Use this tool when you need to determine the caller's public IP address.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Current IP Information

**Slug:** `IPINFO_IO_GET_CURRENT_IP_INFO`

Retrieve comprehensive IP information about the caller's current IP address. Returns geolocation (city, region, country, coordinates, postal code, timezone), ASN details, company info, privacy detection flags (VPN/proxy/Tor), carrier info for mobile IPs, and abuse contact information. Use this when you need to identify and analyze the caller's IP address without specifying an IP parameter.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Current Location

**Slug:** `IPINFO_IO_GET_CURRENT_LOC`

Retrieve 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Current Region

**Slug:** `IPINFO_IO_GET_CURRENT_REGION`

Retrieve 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Geo by IP

**Slug:** `IPINFO_IO_GET_GEO_BY_IP`

Get geolocation data only for an IP address. Returns city, region, country, continent, coordinates, timezone, and postal code. Use this when you need detailed geographic location information for an IP address.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | IPv4 or IPv6 address to look up for geolocation data |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Hostname by IP

**Slug:** `IPINFO_IO_GET_HOSTNAME_BY_IP`

Retrieve 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | A single IPv4 or IPv6 IP address to look up hostname for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get IP by IP

**Slug:** `IPINFO_IO_GET_IP_BY_IP`

Retrieve 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | A single IPv4 or IPv6 IP address to query. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get IP Information

**Slug:** `IPINFO_IO_GET_IP_INFO`

Retrieve 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | No | IP address to look up (IPv4 or IPv6) or 'me' for the caller's IP. Defaults to 'me'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Comprehensive IP Information

**Slug:** `IPINFO_IO_GET_IP_INFO_BY_IP`

Retrieve comprehensive information about a specified IP address. Returns geographic location (city, region, country, coordinates), ASN details, company/organization info, privacy detection flags (VPN, proxy, Tor), carrier information for mobile IPs, and associated domain names. Supports both IPv4 and IPv6 addresses.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | A single IPv4 or IPv6 IP address to look up |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Lite Field By IP

**Slug:** `IPINFO_IO_GET_LITE_FIELD_BY_IP`

Retrieve 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Location by IP

**Slug:** `IPINFO_IO_GET_LOCATION_BY_IP`

Retrieve 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | A single IPv4 or IPv6 IP address to get location coordinates for (e.g., '8.8.8.8' or '2001:4860:4860::8888') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Organization by IP

**Slug:** `IPINFO_IO_GET_ORG_BY_IP`

Retrieve 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').

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | A single IPv4 or IPv6 IP address to look up organization information for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Plus Field for Current IP

**Slug:** `IPINFO_IO_GET_PLUS_FIELD_BY_ME`

Retrieve a specific field from plus IP information about the current IP. Use this tool to get individual fields from IPInfo's Plus API for your current IP address. This includes detailed geographic data (city, region, coordinates), AS information, mobile carrier details, and privacy flags. Each field returns its specific data type (string, number, boolean, or object). Note: This endpoint requires a Plus API subscription. Returns 403 if the subscription doesn't include Plus features.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `field` | 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") | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Postal Code by IP

**Slug:** `IPINFO_IO_GET_POSTAL_BY_IP`

Retrieve 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | A single IPv4 or IPv6 IP address to look up the postal/zip code for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get IP Privacy Details

**Slug:** `IPINFO_IO_GET_PRIVACY_DETAILS`

Retrieve privacy/anonymous IP detection flags for an IP address. Returns whether the IP is associated with VPN, proxy, Tor, relay, or hosting services. Use this to detect potentially anonymous or masked traffic from an IP address. Note: This endpoint requires a Privacy Detection API subscription. If privacy data is unavailable for your subscription level, the action will return default values (all flags set to False).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | IPv4 or IPv6 address to look up for privacy detection |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Region by IP

**Slug:** `IPINFO_IO_GET_REGION_BY_IP`

Retrieve 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | A single IPv4 or IPv6 IP address to retrieve the region/state for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Timezone by IP

**Slug:** `IPINFO_IO_GET_TIMEZONE_BY_IP`

Retrieve 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | IPv4 or IPv6 address to look up timezone for (e.g., '8.8.8.8' or '2001:4860:4860::8888') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Token Information

**Slug:** `IPINFO_IO_GET_TOKEN_INFO`

Retrieve 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Map IP Addresses

**Slug:** `IPINFO_IO_MAP_IPS`

Create 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cli` | integer | No | Optional CLI flag parameter for API compatibility. Set to 1 to enable CLI mode. |
| `ip_addresses` | array | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |