IP ranges API reference

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

IP Ranges Payload

Name	Type	Description
`api`	array	List of IP ranges in CIDR notation used for connections from user site to HCP Terraform APIs
`notifications`	array	List of IP ranges in CIDR notation used for notifications and outbound run task requests
`sentinel`	array	List of IP ranges in CIDR notation used for outbound requests from Sentinel policies
`vcs`	array	List 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 HCP Terraform'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

Status	Response	Reason
200	`application/json`	The request was successful
304	empty body	The 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

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"
  ]
}