---
title: "Regions"
method: GET
path: "/v0/regions/"
tags: ["regions"]
---

# Regions

`GET /v0/regions/`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/carbon-aware/apis/carbon-aware-scheduler/docs/v0/regions/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns list of available regions.

## Response `200`

Successful Response

- RegionResponse
  - `regions` CloudZone[], required
    - `provider` 'aws' | 'gcp' | 'azure' | 'ovh', required
    - `region` union, required
      - 'af-south-1' | 'ap-east-1' | 'ap-northeast-1' | 'ap-northeast-2' | 'ap-northeast-3' | 'ap-south-1' | 'ap-south-2' | 'ap-southeast-2' | 'ap-southeast-3' | 'ap-southeast-4' | 'ap-southeast-5' | 'ap-southeast-7' | 'ca-central-1' | 'ca-west-1' | 'eu-central-1' | 'eu-central-2' | 'eu-north-1' | 'eu-south-1' | 'eu-south-2' | 'eu-west-1' | 'eu-west-2' | 'eu-west-3' | 'il-central-1' | 'me-central-1' | 'mx-central-1' | 'sa-east-1' | 'us-east-1' | 'us-east-2' | 'us-west-1' | 'us-west-2'
      - 'asia-east1' | 'asia-northeast1' | 'asia-southeast1' | 'europe-north1' | 'europe-west1' | 'europe-west3' | 'europe-west4' | 'northamerica-northeast2' | 'southamerica-west1' | 'us-central1' | 'us-east1' | 'us-east4' | 'us-west1' | 'us-west2'
      - 'australiacentral' | 'australiaeast' | 'australiasoutheast' | 'brazilsouth' | 'canadacentral' | 'canadaeast' | 'centralindia' | 'centralus' | 'chinaeast2' | 'chinanorth' | 'chinanorth2' | 'chinanorth3' | 'eastasia' | 'eastus' | 'eastus2' | 'francecentral' | 'germanywestcentral' | 'indonesiacentral' | 'israelcentral' | 'italynorth' | 'japaneast' | 'japanwest' | 'koreacentral' | 'mexicocentral' | 'newzealandnorth' | 'northcentralus' | 'northeurope' | 'norwayeast' | 'polandcentral' | 'southafricanorth' | 'southcentralus' | 'southindia' | 'spaincentral' | 'swedencentral' | 'switzerlandnorth' | 'uaenorth' | 'uksouth' | 'ukwest' | 'westcentralus' | 'westeurope' | 'westus' | 'westus2' | 'westus3'
      - 'fr-strasbourg' | 'pl-warsaw'

## Other responses

- `404`: Not found

## Changes

- **2025-06-04** `2dbf4d087175`: 64 warning, 7 info
  - added the new `af-south-1` enum value to the `regions/items/region/anyOf[subschema #1: AwsRegion]/` response property for the response status `200`
  - added the new `ap-east-1` enum value to the `regions/items/region/anyOf[subschema #1: AwsRegion]/` response property for the response status `200`
  - added the new `ap-northeast-1` enum value to the `regions/items/region/anyOf[subschema #1: AwsRegion]/` response property for the response status `200`
  - added the new `ap-northeast-2` enum value to the `regions/items/region/anyOf[subschema #1: AwsRegion]/` response property for the response status `200`
  - …67 more
- **2025-05-13** `f4d64d241e11`: 2 info
  - added `#/components/schemas/GcpRegion` to the `regions/items/region` response property `anyOf` list for the response status `200`
  - removed `subschema #2: GcpRegion` from the `regions/items/region` response property `anyOf` list for the response status `200`

[Operation history](https://skmtc.dev/carbon-aware/apis/carbon-aware-scheduler/changes/v0/regions/get.md)

---

[API](https://skmtc.dev/carbon-aware/apis/carbon-aware-scheduler.md) - [All operations](https://skmtc.dev/carbon-aware/apis/carbon-aware-scheduler/llms.txt) - [OpenAPI document](https://skmtc.dev/carbon-aware/apis/carbon-aware-scheduler/revisions/2dbf4d087175?raw)