API Responses

Full Response

Here's the full API responses for an example IP address, including the asn object that's included in the standard plan, and the company and carrier objects that are included in the pro plan. If you're on the free or basic plan these additional objects won't be included in the response.

{
  "ip": "66.87.125.72",
  "hostname": "ip-66-87-125-72.spfdma.spcsdns.net",
  "city": "Springfield",
  "region": "Massachusetts",
  "country": "US",
  "loc": "42.0999,-72.5783",
  "postal": "01105",
  "timezone": "America/New_York",
  "asn": {
    "asn": "AS10507",
    "name": "Sprint Personal Communications Systems",
    "domain": "sprint.net",
    "route": "66.87.125.0/24",
    "type": "isp"
  },
  "company": {
    "name": "Sprint Springfield POP",
    "domain": "sprint.com",
    "type": "isp"
  },
  "carrier": {
    "name": "Sprint Corporation",
    "mcc": "310",
    "mnc": "120"
  },
  "privacy": {
    "vpn": true,
    "proxy": false,
    "tor": false,
    "hosting": false
  }
}

ASN Details

The free and basic plans include an org field in the API response that combined the AS number and name. The standard and pro plans include a more detailed ASN object, like follows:

{
  "asn": "AS7922",
  "name": "Comcast Cable Communications, LLC",
  "domain": "comcast.net",
  "route": "73.0.0.0/8",
  "type": "isp"
}

The type field is one of either business, education, hosting or isp.

Our ASN API also allows you to get more details for a given ASN.

Company Details

The pro plan includes a company field in the API response. For larger organizations the company will sometimes be the same as the ASN, but for smaller organizations the ASN will usually correspond to an ISP, and the company to the organization that actually uses the IP address.

{
  "name": "American Heart Association",
  "domain": "americanheart.org",
  "type": "business"
}

The type field is one of either business, education, hosting or isp.

Carrier Details

The pro plan includes a carrier field in the API response. This is included if our data analysis has shown with a very high likelihood that this IP addresses is used exclusively for mobile carrier traffic. Along with the common carrier name we also include GSM network codes.

{
  "name": "Sprint",
  "mcc": "310",
  "mnc": "120"
}