Regions v4.176.0
Regions List
Lists the Regions available for Linode services. Not all services are guaranteed to be available in all Regions.
Authorizations
Request Samples
curl https://api.linode.com/v4/regions
linode-cli regions list
Response Samples
{
  "data": [
    {
      "capabilities": [
        "Linodes",
        "NodeBalancers",
        "Block Storage",
        "Object Storage"
      ],
      "country": "us",
      "id": "us-east",
      "label": "Newark, NJ, USA",
      "resolvers": {
        "ipv4": "192.0.2.0,192.0.2.1",
        "ipv6": "2001:0db8::,2001:0db8::1"
      },
      "status": "ok"
    }
  ],
  "page": 1,
  "pages": 1,
  "results": 1
}{
  "errors": [
    {
      "field": "fieldname",
      "reason": "fieldname must be a valid value"
    }
  ]
}Responses
data  | array
of objects
  | ||||||||||||||||
page  | integerThe current page.  | ||||||||||||||||
pages  | integerThe total number of pages.  | ||||||||||||||||
results  | integerThe total number of results.  | 
errors  | array
of objects
  | 
Regions Availability List
Returns availability data for all Regions.
Currently, this command returns availability of select premium and GPU plans for select regions.
Authorizations
Request Samples
curl https://api.linode.com/v4/regions/availability
linode-cli regions list-avail
Response Samples
{
  "data": [
    {
      "available": true,
      "plan": "gpu-rtx6000-1.1",
      "region": "us-east"
    }
  ],
  "page": 1,
  "pages": 1,
  "results": 1
}{
  "errors": [
    {
      "field": "fieldname",
      "reason": "fieldname must be a valid value"
    }
  ]
}Responses
data  | array
of objects
  | ||||||
page  | integerThe current page.  | ||||||
pages  | integerThe total number of pages.  | ||||||
results  | integerThe total number of results.  | 
errors  | array
of objects
  | 
Region View
Returns a single Region.
Authorizations
Path Parameters
| regionId | stringRequiredID of the Region to look up.  | 
Request Samples
curl https://api.linode.com/v4/regions/us-east
linode-cli regions view us-east
Response Samples
{
  "capabilities": [
    "Linodes",
    "NodeBalancers",
    "Block Storage",
    "Object Storage"
  ],
  "country": "us",
  "id": "us-east",
  "label": "Newark, NJ, USA",
  "resolvers": {
    "ipv4": "192.0.2.0,192.0.2.1",
    "ipv6": "2001:0db8::,2001:0db8::1"
  },
  "status": "ok"
}{
  "errors": [
    {
      "field": "fieldname",
      "reason": "fieldname must be a valid value"
    }
  ]
}Responses
capabilities  | array
of stringsA list of capabilities of this region.  | ||||
country  | stringThe country where this Region resides.  | ||||
id  | stringThe unique ID of this Region.  | ||||
label  | stringDetailed location information for this Region, including city, state or region, and country.  | ||||
resolvers  | object
  | ||||
status  | stringEnum:
 ok
outageThis region’s current operational status.  | 
errors  | array
of objects
  | 
Region Availability View
Returns availability data for a single Region.
Authorizations
Path Parameters
| regionId | stringRequiredID of the Region to look up.  | 
Request Samples
curl https://api.linode.com/v4/regions/us-east/availability
linode-cli regions view-avail us-east
Response Samples
{
  "available": true,
  "plan": "gpu-rtx6000-1.1",
  "region": "us-east"
}{
  "errors": [
    {
      "field": "fieldname",
      "reason": "fieldname must be a valid value"
    }
  ]
}Responses
available  | booleanWhether the compute instance type is available in the region.  | 
plan  | stringThe compute instance Type ID.  | 
region  | stringThe Region ID.  | 
errors  | array
of objects
  |