latestOpenAPI 3.0.3Netlas API & Data License Agreement2026-08-104487309.0 KB

2b1f84425791

Host Info

Caller’s Host Summary

Retrieves the latest available data for the IP address of the client making the request.

Use this method to obtain information about your own IP address.

get/api/host/

Query parameters

fieldsField[]

You can control the amount of output data by specifying which fields to include or exclude in the response. Use the source_type parameter to select between include and exclude options.

[
  "*"
]

source_type'include' | 'exclude'

Specify fields and use source_type to choose between:

include to return only the specified fields
exclude to return all fields except the specified ones

public_indices_onlyboolean

By default, data is requested from both private and public indices, returning the most recent results. Use this query parameter to restrict the search to public indices only.

Example:true

Response

Host Summary

type'ip' required

ipstring required

A valid IPv4 address.

ptrstring[]

A list of reverse DNS (PTR) records associated with the IP address.

geoGeo

Estimated geolocation and timezone information for the host.

privacyPrivacy

Indicates if this IP hosts a VPN, proxy, or Tor exit node.

organizationstring

The organization associated with the host.

domainsstring[]

The first 10 domains associated with the IP address via DNS records.

domains_countinteger

Total number of domains associated with the IP address

whoisIpWhoisDocument

WHOIS information for an IP address

portsobject[]

A list of open ports detected during the scan.

softwareobject[]

A list of software and technologies identified on the host.

iocobject[]

Indicators of compromise (IoCs) provided by third-party sources.

sourceobject[]

A list of data sources where the information was retrieved.

Example response

{
  "ip": "23.215.0.136",
  "ptr": [
    "a23-215-0-136.deploy.static.akamaitechnologies.com"
  ],
  "geo": {
    "continent": "North America",
    "country": "US",
    "tz": "America/Chicago",
    "location": {
      "lat": 37.751,
      "lon": -97.822
    },
    "accuracy": 1000
  },
  "privacy": {
    "vpn": false,
    "proxy": false,
    "tor": false
  },
  "organization": "Example Technologies, Inc.",
  "domains": [
    "example.com",
    "example.net"
  ],
  "domains_count": 2,
  "whois": {
    "abuse": "abuse@akamai.com",
    "@timestamp": "2025-01-07T05:17:39",
    "raw": "Raw WHOIS data in the form of a string will be here.\n\nThe rest of the document contains the same data in parsed form.",
    "ip": {
      "gte": "23.214.224.0",
      "lte": "23.215.8.255"
    },
    "related_nets": [],
    "net": {
      "country": "US",
      "address": "145 Broadway",
      "city": "Cambridge",
      "created": "2013-07-12",
      "range": "23.192.0.0 - 23.223.255.255",
      "description": "Akamai Technologies, Inc.",
      "handle": "NET-23-192-0-0-1",
      "organization": "Akamai Technologies, Inc. (AKAMAI)",
      "name": "AKAMAI",
      "start_ip": "23.192.0.0",
      "cidr": [
        "23.192.0.0/11"
      ],
      "net_size": 2097151,
      "state": "MA",
      "postal_code": "02142",
      "updated": "2013-08-09",
      "end_ip": "23.223.255.255",
      "contacts": {
        "emails": [
          "ip-admin@akamai.com",
          "abuse@akamai.com"
        ],
        "phones": [
          "+1-617-274-7134",
          "+1-617-444-2535",
          "+1-617-444-0017"
        ]
      }
    },
    "asn": {
      "number": [
        "16625"
      ],
      "registry": "arin",
      "country": "US",
      "name": "AKAMAI-AS",
      "cidr": "23.214.224.0/19",
      "updated": "2013-07-12"
    }
  },
  "ports": [
    {
      "protocol": "http",
      "prot4": "tcp",
      "port": 80,
      "prot7": "http"
    },
    {
      "protocol": "https",
      "prot4": "tcp",
      "port": 443,
      "prot7": "http"
    }
  ],
  "software": [
    {
      "tag": [
        {
          "azure_cdn": {
            "version": ""
          },
          "name": "azure_cdn",
          "fullname": "Azure CDN",
          "category": [
            "CDN"
          ]
        }
      ],
      "uri": "https://example.com:443/public_html/glenfiddich-animation/"
    }
  ],
  "ioc": [
    {
      "lseen": "2024-01-19T00:00Z",
      "fseen": "2024-01-19T00:00Z",
      "domain": "example.com",
      "url": "https://example.com/assets/index.php",
      "tags": [
        "malware"
      ]
    }
  ],
  "source": [
    {
      "id": 4701,
      "name": "perimeter-1741688290-9rc7tkern-demo-1-responses",
      "availability": "private",
      "label": "23.215.0.136, example.com"
    }
  ]
}