A new platform for documentation and tutorials is launching soon.

We are migrating Terraform documentation into HashiCorp Developer, our new developer experience.

Join Now
Type '/' to Search

»IP Ranges API

IP Ranges provides a list of Terraform Cloud's IP ranges. For more information about Terraform Cloud's IP ranges, view our documentation about Terraform Cloud IP Ranges.

»IP Ranges Payload

NameTypeDescription
apiarrayList of IP ranges in CIDR notation used for connections from user site to Terraform Cloud APIs
notificationsarrayList of IP ranges in CIDR notation used for notifications and outbound run task requests
sentinelarrayList of IP ranges in CIDR notation used for outbound requests from Sentinel policies
vcsarrayList of IP ranges in CIDR notation used for connecting to VCS providers

Note: The IP ranges for each feature returned by the IP Ranges API may overlap. Additionally, these published ranges do not currently allow for execution of Terraform runs against local resources.

Note: Under normal circumstances, HashiCorp will publish any expected changes to Terraform Cloud's IP ranges at least 24 hours in advance of implementing them. This should allow sufficient time for users to update any connected systems to reflect the changes. In the event of an emergency outage or failover operation, it may not be possible to pre-publish these changes.

»Get IP Ranges

Note: The IP Ranges API does not require authentication

Note: This endpoint supports the If-Modified-Since HTTP request header

GET /meta/ip-ranges

StatusResponseReason
200application/jsonThe request was successful
304empty bodyThe request was successful; IP ranges were not modified since the specified date in If-Modified-Since header

»Sample Request

curl \
  --request GET \
  -H "If-Modified-Since: Tue, 26 May 2020 15:10:05 GMT" \
  https://app.terraform.io/api/meta/ip-ranges

curl \
  --request GET \
  -H "If-Modified-Since: Tue, 26 May 2020 15:10:05 GMT" \
  https://app.terraform.io/api/meta/ip-ranges

»Sample Response

{
  "api": [
    "75.2.98.97/32",
    "99.83.150.238/32"
  ],
  "notifications": [
    "10.0.0.1/32",
    "192.168.0.1/32",
    "172.16.0.1/32"
  ],
  "sentinel": [
    "10.0.0.1/32",
    "192.168.0.1/32",
    "172.16.0.1/32"
  ],
  "vcs": [
    "10.0.0.1/32",
    "192.168.0.1/32",
    "172.16.0.1/32"
  ]
}

{
  "api": [
    "75.2.98.97/32",
    "99.83.150.238/32"
  ],
  "notifications": [
    "10.0.0.1/32",
    "192.168.0.1/32",
    "172.16.0.1/32"
  ],
  "sentinel": [
    "10.0.0.1/32",
    "192.168.0.1/32",
    "172.16.0.1/32"
  ],
  "vcs": [
    "10.0.0.1/32",
    "192.168.0.1/32",
    "172.16.0.1/32"
  ]
}