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

# List Regions

`GET /regions`

## Request

- Base URL: `https://api.bunny.net/mc`
- URL: `https://api.bunny.net/mc/regions`
- Auth: API key in header `AccessKey`
- TypeScript: <https://skmtc.dev/bunny/apis/magic-containers-api/docs/regions/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists all available regions where applications can be deployed, including their anycast support and capacity status. Optionally filter by GPU type and required GPU count.

## Query parameters

- `gpuType` string
- `gpuCount` integer
- `nextCursor` string
- `limit` integer

## Response `200`

Regions were successfully retrieved.

- ListRegionsResponse
  - `items` Region[]
    - `id` string
    - `name` string
    - `group` string
    - `hasAnycastSupport` boolean
    - `hasCapacity` boolean
    - `gpuTypes` string[]
  - `meta` ListMeta
    - `totalItems` integer
  - `cursor` string, nullable

## Other responses

- `400`: Bad Request
- `401`: User is unauthorized.
- `500`: Unexpected server error.

## Changes

- **2026-11-12** `7bb58a0591b0`: 3 info
  - added the new optional `query` request parameter `gpuCount`
  - added the new optional `query` request parameter `gpuType`
  - added the optional property `items/items/gpuTypes` to the response with the `200` status
- **2026-04-26** `62fb48c758fb`: 4 info
  - added the optional property `id` to the response with the `400` status
  - added the optional property `id` to the response with the `500` status
  - the response property `errors/items/message` became required for the status `400`
  - the response property `errors/items/message` became required for the status `500`

[Operation history](https://skmtc.dev/bunny/apis/magic-containers-api/changes/regions/get.md)

---

[API](https://skmtc.dev/bunny/apis/magic-containers-api.md) - [All operations](https://skmtc.dev/bunny/apis/magic-containers-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bunny/apis/magic-containers-api/revisions/7bb58a0591b0?raw)
