# Ipdata.co

ipdata provides a simple HTTP-based API that allows you to look up the location, ownership, and threat profile of any IP address.

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

## Tools

### Advanced ASN Lookup

**Slug:** `IPDATA_CO_ADVANCED_ASN_LOOKUP`

Tool to perform advanced ASN lookup returning prefixes, peers, and registry details. Use after confirming ASN number when detailed ASN info is required.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `asn` | integer | Yes | Autonomous System Number to look up (positive integer, e.g., 2). |
| `fields` | string | No | Comma-separated list of specific fields to return (e.g., 'name,ipv4_prefixes'). |

#### 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 |

### EU IP Lookup (Specific IP)

**Slug:** `IPDATA_CO_EU_LOOKUP_SPECIFIC_IP`

Lookup geolocation, threat intel, and network data for a specific IP address using the EU data residency endpoint. Use this tool when: - You need IP lookup with GDPR compliance (data processed and stored only within EU datacenters) - Looking up any IPv4 or IPv6 address for location, ASN, threat, or company information The EU endpoint (eu-api.ipdata.co) ensures all API requests are routed through EU-based servers in Frankfurt, Paris, and Ireland.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | The IPv4 or IPv6 address to look up (e.g., '8.8.8.8' or '2001:4860:4860::8888') |
| `fields` | string | No | Comma-separated list of response fields to include. Use this to reduce response size if you only need specific data. Available fields: ip, is_eu, city, region, region_code, country_name, country_code, continent_name, continent_code, latitude, longitude, postal, calling_code, flag, emoji_flag, emoji_unicode, asn, company, carrier, languages, currency, time_zone, threat, count |
| `callback` | string | No | JSONP callback function name for wrapping the response (rarely needed for API use) |

#### 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 |

### IPData: Calling Code

**Slug:** `IPDATA_CO_FIELD_CALLING_CODE`

Tool to fetch the international calling_code for an IP's country. Use when you need only the calling code field from ipdata_co.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | No | IPv4 or IPv6 address to lookup. If omitted, the caller's IP address is used. |

#### 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 |

### IPDATA Field Carrier

**Slug:** `IPDATA_CO_FIELD_CARRIER`

Retrieve mobile carrier information (name, MCC, MNC) for an IP address. Returns carrier data only for mobile network IPs; non-mobile IPs return null fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | No | IPv4 or IPv6 address to query. If omitted, defaults to the caller's IP. |

#### 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 from IP

**Slug:** `IPDATA_CO_FIELD_CITY`

Tool to return only city for an IP. Use when only the city name is required.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | No | IPv4 or IPv6 address to look up. If omitted, uses the calling IP. |

#### 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 |

### IPData: Continent Code

**Slug:** `IPDATA_CO_FIELD_CONTINENT_CODE`

Retrieve the continent code for a given IP address. Returns a two-letter code (AF, AN, AS, EU, NA, OC, SA) indicating which continent the IP is geographically located in. Use this when you only need the continent information without full IP geolocation details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | No | IPv4 or IPv6 address to look up. If omitted, uses the calling IP. |

#### 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 Continent Name from IP

**Slug:** `IPDATA_CO_FIELD_CONTINENT_NAME`

Tool to return only continent name for an IP. Use when only the continent name is required.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | No | IPv4 or IPv6 address to look up. If omitted, uses the calling IP. |

#### 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 |

### IPDATA Field Count

**Slug:** `IPDATA_CO_FIELD_COUNT`

Tool to return only the request count made by your API key in the last 24 hours. Use when monitoring your API usage and you only need the total count.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | No | Optional IPv4 or IPv6 address. The count returned is always your API key's total requests in the last 24 hours, regardless of whether an IP is specified. |

#### 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 |

### IPData: Country Code

**Slug:** `IPDATA_CO_FIELD_COUNTRY_CODE`

Tool to return only country_code for an IP. Use when only the 2-letter country code is required.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | No | IPv4 or IPv6 address to look up. If omitted, uses the calling IP. |

#### 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 Name from IP

**Slug:** `IPDATA_CO_FIELD_COUNTRY_NAME`

Get the country name for an IP address using ipdata.co geolocation API. Returns only the country name (e.g., 'United States', 'Germany', 'Japan'). Use this lightweight action when you only need the country name without full IP details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | No | IPv4 or IPv6 address to look up. If omitted, uses the calling IP. |

#### 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 |

### IPDATA Field Currency

**Slug:** `IPDATA_CO_FIELD_CURRENCY`

Tool to return only currency object for an IP. Use when currency details are needed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | No | IPv4 or IPv6 address to query. If omitted, uses the caller's IP. |

#### 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 Emoji Flag from IP

**Slug:** `IPDATA_CO_FIELD_EMOJI_FLAG`

Tool to return only emoji flag for an IP. Use when only the country flag emoji is required.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | No | IPv4 or IPv6 address to look up. If omitted, uses the calling IP. |

#### 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 Emoji Unicode from IP

**Slug:** `IPDATA_CO_FIELD_EMOJI_UNICODE`

Tool to return only emoji_unicode for an IP. Use when only the Unicode country flag emoji is required.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | No | IPv4 or IPv6 address to look up. If omitted, uses the calling IP. |

#### 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 |

### IPData: IP

**Slug:** `IPDATA_CO_FIELD_IP`

Retrieve the public IP address of the calling client. This action calls the IPData API to determine the caller's external/public IP address. It returns only the IP string with no additional geolocation data. Use this when you need to identify your own 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 |

### IPData: Is EU

**Slug:** `IPDATA_CO_FIELD_IS_EU`

Tool to return only is_eu for an IP. Use when you need to determine if an IP's country belongs to the EU.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | No | IPv4 or IPv6 address to look up. If omitted, uses the calling IP. |

#### 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 |

### IPData: Languages

**Slug:** `IPDATA_CO_FIELD_LANGUAGES`

Tool to return only the languages array for an IP. Use when only language details for an IP are required.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | No | IPv4 or IPv6 address to look up. If omitted, uses the calling IP. |

#### 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 |

### IPData: Latitude

**Slug:** `IPDATA_CO_FIELD_LATITUDE`

Tool to return only the latitude for an IP. Use when only the latitude coordinate is needed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | No | IPv4 or IPv6 address to look up. If omitted, uses the caller's IP. |

#### 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 Longitude from IP

**Slug:** `IPDATA_CO_FIELD_LONGITUDE`

Tool to return only longitude for an IP. Use when only the longitude value is required.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | No | IPv4 or IPv6 address to look up. If omitted, uses the calling IP. |

#### 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 |

### IPData: Postal Code

**Slug:** `IPDATA_CO_FIELD_POSTAL`

Tool to return only postal code for an IP. Use when only the postal code (ZIP/postcode) is required.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | No | IPv4 or IPv6 address to look up. If omitted, uses the calling IP. |

#### 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 from IP

**Slug:** `IPDATA_CO_FIELD_REGION`

Tool to return only region for an IP. Use when only the region name is required.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | No | IPv4 or IPv6 address to look up; if omitted, uses the calling IP. |

#### 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 |

### IPData: Region Code

**Slug:** `IPDATA_CO_FIELD_REGION_CODE`

Tool to return only region_code for an IP. Use when only the ISO 3166-2 region code is required.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | No | IPv4 or IPv6 address to look up. If omitted, uses the calling IP. |

#### 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 Threat for IP

**Slug:** `IPDATA_CO_FIELD_THREAT`

Retrieve threat intelligence data for a specific IP address or the calling IP. Returns indicators such as Tor exit node status, proxy detection, datacenter/cloud provider identification, known attacker/abuser flags, and blocklist appearances. Use this tool when you need to assess the security risk or reputation of an IP address.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | No | IPv4 or IPv6 address to look up. If omitted, uses the calling IP. |

#### 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 |

### IPData: Time Zone

**Slug:** `IPDATA_CO_FIELD_TIME_ZONE`

Tool to return only the time_zone object for an IP. Use when only timezone data is required.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | No | IPv4 or IPv6 address to look up. If omitted, uses the calling IP. |

#### 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 |

### IPData Basic ASN for IP

**Slug:** `IPDATA_CO_IP_DATA_BASIC_ASN_FOR_IP`

Tool to return basic ASN data for a specific IP. Use when you need ASN number, organization, domain, route, and type details.

#### Input Parameters

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

### IPData Bulk Lookup V1

**Slug:** `IPDATA_CO_IPDATA_BULK_LOOKUP_V1`

Tool to bulk lookup up to 100 IP addresses via ipdata.co. Use when you have multiple IPs and need geolocation and threat data in one call.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ips` | array | Yes | List of IPv4 or IPv6 addresses to lookup (1-100). |

#### 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 data for IP

**Slug:** `IPDATA_CO_IP_DATA_COMPANY_FOR_IP`

Tool to retrieve company data for a given IP address. Use when you need the organization name, domain, network prefix, and usage type for an IPv4 or IPv6.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | Target IPv4 or IPv6 address (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 |

### EU IP Lookup (Calling IP)

**Slug:** `IPDATA_CO_IPDATA_EU_LOOKUP_CALLING_IP`

Lookup geolocation, network, and threat data for the calling client's IP address using the EU-residency endpoint. Use this action when you need IP data processed and stored entirely within the European Union (GDPR compliance). The EU endpoint routes requests only through EU datacenters (Frankfurt, Paris, Ireland). This action automatically detects and returns data for the IP address making the API request. No IP address parameter is needed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fields` | string | No | Comma-separated list of response fields to include. Available fields: ip, is_eu, city, region, region_code, country_name, country_code, continent_name, continent_code, latitude, longitude, postal, calling_code, flag, emoji_flag, emoji_unicode, asn, carrier, languages, currency, time_zone, threat, company. Example: 'ip,city,country_name,is_eu'. Omit to return all fields. |

#### 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 |

### IPData Lookup IP V1

**Slug:** `IPDATA_CO_IP_DATA_LOOKUP_IP_V1`

Tool to lookup comprehensive IP information (geolocation, network, company, and threat data) in one call. Use when you need all IP insights together.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | IPv4 or IPv6 address to look up |
| `fields` | string | No | Comma-separated list of response fields to return, e.g., ip,is_eu,city,region,region_code,country_name,country_code,continent_name,continent_code,latitude,longitude,asn,company,postal,calling_code,flag,emoji_flag,emoji_unicode,carrier,languages,currency,time_zone,threat,count |
| `callback` | string | No | JSONP callback function 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 |