--- title: IPInfo slug: connectors/ipinfo docTags: createdAt: 2026-06-09T16:30:17.237Z --- This readme file provides information and instructions on how to use the IPINFO.IO Connector Integration, which allows you to retrieve IP address information directly from the IPINFO.IO API. IPInfo provides detailed IP address data, including geolocation and ASN information, for enhanced security and analytics. IPInfo is a leading provider of IP address data, offering detailed insights into IP addresses worldwide. This connector allows users to retrieve comprehensive information about specific IP addresses and discover domains hosted on them. By integrating IPInfo with Swimlane Turbine, users can enrich security events with IP intelligence, enhancing threat detection and response capabilities. This integration empowers security teams to automate IP data retrieval and streamline their security workflows without writing code. ## Prerequisites Before you can use the IPInfo connector for Turbine, you'll need access to the IPInfo API. This requires the following: - an IPInfo asset using the following parameter: - Token: A valid IPInfo Enterprise plan token required for authentication. ## Requirements To use the IPINFO.IO Connector Integration, you will need: A valid IPINFO.IO API key An active subscription to the IPINFO.IO service Keep in mind that to use all possible outputs, a Business Subscription is needed. ## Actions The IPINFO.IO Connector currently exposes the following actions: | Action | Description | API Method | | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | | Get IP | Returns IP address details (geolocation, ASN, company, privacy, abuse, etc.). | `GET /{ip}` | | Hosted Domains | Returns a list of domains hosted on the provided IP address. Supports pagination via `page` and `limit`. Requires an IPinfo Enterprise plan token. | `GET /domains/{ip}` | ## API Documentation For full documentation on the IPINFO.IO API, including detailed information on available endpoints and response formats, please refer to the official [IPINFO.IO documentation](https://ipinfo.io/developers). For details on the Hosted Domains endpoint specifically, see the [Hosted Domains API documentation](https://ipinfo.io/developers/hosted-domains). # Configurations ## IPInfo Asset IPInfo Asset ### Configuration Parameters | **Parameter** | **Description** | **Type** | **Required** | | ------------- | --------------- | -------- | ------------ | | token | The API key | string | Required | # Actions ## Get IP Retrieve detailed information about a specific IP address using IPInfo. This action requires the IP address as input. ### Endpoint - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ----------------- | -------- | ------------ | -------------------- | | `ip` | string | Required | Parameter for Get IP | ### Input Example `{"ip":"66.87.125.5"}` ### Output | **Parameter** | **Type** | **Description** | | ------------------------ | -------- | ------------------------------------ | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `headers` | object | HTTP headers for the request | | `details` | object | Output field: details | | `details.ip` | string | Output field: details.ip | | `details.hostname` | string | Name of the resource | | `details.city` | string | Output field: details.city | | `details.region` | string | Output field: details.region | | `details.country` | string | Output field: details.country | | `details.loc` | string | Output field: details.loc | | `details.postal` | string | Output field: details.postal | | `details.timezone` | string | Output field: details.timezone | | `details.asn` | object | Output field: details.asn | | `details.asn.asn` | string | Output field: details.asn.asn | | `details.asn.name` | string | Name of the resource | | `details.asn.domain` | string | Output field: details.asn.domain | | `details.asn.route` | string | Output field: details.asn.route | | `details.asn.type` | string | Type of the resource | | `details.company` | object | Output field: details.company | | `details.company.name` | string | Name of the resource | | `details.company.domain` | string | Output field: details.company.domain | | `details.company.type` | string | Type of the resource | | `details.carrier` | object | Output field: details.carrier | | `details.carrier.name` | string | Name of the resource | | `details.carrier.mcc` | string | Output field: details.carrier.mcc | ### Output Example `{"status_code":200,"reason":"Ok","headers":null,"details":{"ip":"66.87.125.5","hostname":"ip-66-87-125-5.spfdma.spcsdns.net","city":"Springfield","region":"Massachusetts","country":"US","loc":"42.1015,-72.5898","postal":"01101","timezone":"America/New_York","asn":{"asn":"AS10507","name":"Sprint Personal Communications Systems","domain":"sprint.pl","route":"66.87.125.0/24","type":"isp"},"company":{"name":"T-Mobile USA, Inc.","domain":"t-mobile.com","type":"isp"},"carrier":{"name":"T-Mobile","mcc"...` ## Hosted Domains Retrieve a list of domains hosted on a specified IP address with pagination support. Requires an IPinfo Enterprise plan token. ### Endpoint - **URL:** `/domains/{ip}` - **Method:** `GET` ### Input | **Argument Name** | **Type** | **Required** | **Description** | | ----------------- | -------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------- | | `ip` | string | Required | The IP address to look up hosted domains for. | | `page` | integer | Optional | Zero-based page index used to paginate through results. The page parameter is echoed back in the response when included in the request. | | `limit` | integer | Optional | Maximum number of domains to return per page. The API caps results at 1,000 domains per IP address. | ### Input Example `{"ip":"198.35.26.96","page":0,"limit":100}` ### Output | **Parameter** | **Type** | **Description** | | ------------------ | -------- | ----------------------------------------------------------- | | `status_code` | number | HTTP status code of the response | | `reason` | string | Response reason phrase | | `headers` | object | HTTP headers for the request | | `response` | object | Output field: response | | `response.ip` | string | Output field: response.ip | | `response.total` | number | Total number of domains hosted on the IP address. | | `response.page` | number | Page index echoed back when the page parameter is supplied. | | `response.domains` | array | List of domains hosted on the IP address for this page. | ### Output Example `{"status_code":200,"reason":"OK","headers":null,"response":{"ip":"198.35.26.96","total":16596,"page":0,"domains":["wikipedia.org","wikimedia.org","wiktionary.org"]}}` # Response Headers | **Header** | **Description** | **Example** | | ------------ | ----------------------------------------------------- | ----------------------------- | | Content-Type | The media type of the resource | application/json | | Date | The date and time at which the message was originated | Thu, 01 Jan 2024 00:00:00 GMT |