Datacenter IP Address API

I maintain a public API to check whether an IP address belongs to a data center IP address range such as Azure, AWS, Digitalocean, Google Cloud Platform and many other cloud providers. Please read the full blog article for more a through introduction.

• API Version: v0.3 (6th November 2021)
• API Endpoint: https://api.incolumitas.com/datacenter?ip=3.5.140.2
• Supported Datacenters: Amazon AWS, Microsoft Azure, Google Cloud, IBM Cloud, OVH, Digital Ocean, Hetzner Online, CloudFlare, Oracle Cloud, Tor Network and many more
• IPv6 Support: Yes

Live API

{
  "message": "Please make an API request",
}

ChangeLog

6th November 2021

• Updated all IP address ranges
• Add cloud provider m247 Ltd, servers.com Inc., Leaseweb Usa Inc., often used for proxies/fraud
• Checking for common datacenter in whois lookup

29th September 2021

• Updated all IP address ranges
• Added dedicated API endpoint: https://api.incolumitas.com/datacenter?ip=3.5.140.2
• Old API Endpoint: https://abs.incolumitas.com/datacenter?ip=1.2.3.4

API Usage

You can reach the API endpoint with this URL: https://api.incolumitas.com/datacenter?ip=

If you pass the IP address 3.5.140.2 to the API by calling https://api.incolumitas.com/datacenter?ip=3.5.140.2, you'll obtain the result:

{
  "ip": "3.5.140.2",
  "region": "ap-northeast-2",
  "service": "AMAZON",
  "network_border_group": "ap-northeast-2"
}

Alternatively, you can also lookup IPv6 addresses. Try the url https://api.incolumitas.com/datacenter?ip=2406:dafe:e0ff:ffff:ffff:ffff:dead:beef, which yields:

{
  "ip": "2406:dafe:e0ff:ffff:ffff:ffff:dead:beef",
  "region": "ap-east-1",
  "service": "AMAZON",
  "network_border_group": "ap-east-1"
}

If you don't specify any IP address with the ip= query parameter and you invoke https://api.incolumitas.com/datacenter directly, the client's own IP address will be used for lookup. In my case, I get the following output:

{
  "ip": "84.155.231.57",
  "service": "No match for this IP address"
}

because my private ISP IP address obviously doesn't belong to any datacenter.

Usage with JavaScript:

fetch('https://api.incolumitas.com/datacenter') 
.then(response => response.json())
.then(function(data) {
  console.log(data)
})

The IP address ranges for the cloud providers are kept up to date and the IP ranges are pulled from the upstream sources every 4 hours.

More Examples for the IP Address Datacenter API

In the following section, I will show examples for looking up IP addresses belonging to the three biggest cloud providers AWS, Azure and GCP:

Looking up an Azure IP address: https://api.incolumitas.com/datacenter?ip=20.41.193.225

{
  "ip": "20.41.193.225",
  "name": "AzurePortal",
  "region": "",
  "regionId": 0,
  "platform": "Azure",
  "systemService": "AzurePortal"
}

Looking up an AWS IP address: https://api.incolumitas.com/datacenter?ip=3.5.140.2

{
  "ip": "3.5.140.2",
  "region": "ap-northeast-2",
  "service": "AMAZON",
  "network_border_group": "ap-northeast-2"
}

Looking up an GCP IP address: https://api.incolumitas.com/datacenter?ip=23.236.48.55

{
  "ip": "23.236.48.55",
  "service": "GCP"
}

And looking up a AWS IPv6 address: https://api.incolumitas.com/datacenter?ip=2600:1F18:7FFF:F800:0000:ffff:0000:0000:

{
  "ip": "2600:1F18:7FFF:F800:0000:ffff:0000:0000",
  "region": "us-east-1",
  "service": "AMAZON",
  "network_border_group": "us-east-1"
}

As you can see from the example lookups above, sometimes the API gives additional meta data information for a specific IP address such as regional and data center information.

What cloud providers are supported by the API?

Currently, the API supports IP address ranges from the following cloud providers:

The API database is updated every 4 hours with the official source of the IP address ranges of the cloud provides listed above (with a ✓). For some cloud providers such as OVH or Hetzner there is no official IP address range source, so I have to rely on third party sources.