---
title: "List regions"
method: GET
path: "/cloud/v1/regions"
tags: ["Regions"]
---

# List regions

`GET /cloud/v1/regions`

## Query parameters

- `display_name` string — Filter regions by display name. Case-insensitive exact match.
- `limit` integer — Limit the number of returned regions. Falls back to default of 100 if not specified. Limited by max limit value of 1000
- `offset` integer — Offset value is used to exclude the first set of records from the result
- `order_by` 'created_at.asc' | 'created_at.desc' | 'display_name.asc' | 'display_name.desc'
- `product` 'containers' | 'inference'
- `show_volume_types` boolean — If true, null `available_volume_type` is replaced with a list of available volume types.

## Response `200`

OK

- RegionCollectionSerializer
  - `count` integer, required — Number of objects
  - `results` RegionSerializer[], required — Objects
    - `access_level` 'core' | 'edge', required
    - `available_volume_types` string[], nullable, required — List of available volume types, 'standard', 'ssd_hiiops', 'cold'].
    - `coordinates` Coordinate, required
      - `latitude` string, required
      - `longitude` string, required
    - `country` string, required — Two-letter country code, ISO 3166-1 alpha-2
    - `created_at` string, date-time, required — Region creation date and time
    - `created_on` string, date-time, required — This field is deprecated. Use `created_at` instead.
    - `ddos_endpoint_id` integer, nullable — DDoS endpoint ID
    - `display_name` string, required — Human-readable region name
    - `endpoint_type` 'admin' | 'internal' | 'public', required
    - `external_network_id` string, nullable, required — External network ID for Neutron
    - `file_share_types` FileShareStorageType[], nullable, required — List of available file share types
    - `has_ai` boolean, required — Region has AI capability
    - `has_ai_gpu` boolean, required — Region has AI GPU capability
    - `has_baremetal` boolean, required — Region has bare metal capability
    - `has_basic_vm` boolean, required — Region has basic vm capability
    - `has_dbaas` boolean, required — Region has DBAAS service
    - `has_ddos` boolean, required — Region has Advanced DDoS Protection capability
    - `has_k8s` boolean, required — Region has managed kubernetes capability
    - `has_kvm` boolean, required — Region has KVM virtualization capability
    - `has_sfs` boolean, required — Region has SFS capability
    - `id` integer, required — Region ID
    - `keystone_id` integer, required — Foreign key to Keystone entity
    - `keystone_name` string, required — Technical region name
    - `metrics_database_id` integer, nullable, required — Foreign key to Metrics database entity
    - `slug` string, required — Short, human-readable region identifier (e.g. luxembourg-2, santa-clara-1).
    - `state` 'ACTIVE' | 'DELETED' | 'DELETING' | 'DELETION_FAILED' | 'INACTIVE' | 'MAINTENANCE' | 'NEW', required
    - `task_id` string, nullable, required — This field is deprecated and can be ignored
    - `vlan_physical_network` string, required — Physical network name to create vlan networks
    - `zone` 'AMERICAS' | 'APAC' | 'EMEA' | 'RUSSIA_AND_CIS', required

---

[API](https://skmtc.net/g-core/apis/gcore-openapi.md) · [All operations](https://skmtc.net/g-core/apis/gcore-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/g-core/gcore-openapi/revisions/09e652815095/schema)