# List regions

`GET /v1/regions`

Returns the available regions where apps can be deployed.

## Header parameters

- `Authorization` (string, required): `Bearer <token>`. [Authentication](https://spice.ai/docs/cloud/api/management#authentication) lists the tokens it accepts.
- `X-Org-Name` (string, optional): The organization to act on, by handle. Omit it to act on the organization the credential is bound to; sending it blank is a 400, not the same as omitting it. A user credential may name any organization its owner belongs to; a machine credential is pinned to its own. A portal session token is bound to none, so it must send this header on every route but `GET /v1/orgs` (400 `org_assertion_required` otherwise). Pattern: `^[A-Za-z0-9._-]{1,255}$`.

## Example request

```bash
curl "https://api.spice.ai/v1/regions" \
  -H "Authorization: Bearer <token>"
```

```http
GET /v1/regions HTTP/1.1
Host: api.spice.ai
Authorization: Bearer <token>
```

## Responses

**200 OK**

List of available regions

Content type: `application/json`

- `regions` (array of object)
  - `name` (string): Human-readable region name
  - `region` (string): Region identifier (e.g., us-east-2)
  - `provider` (string): Allowed values: `teraswitch`, `aws`, `azure`.
  - `providerName` (string): Allowed values: `Teraswitch`, `AWS`, `Azure`.
  - `isDefault` (boolean)
  - `disabled` (boolean)
- `default` (string): The default region identifier

**401 Unauthorized**

Unauthorized

**403 Forbidden**

Insufficient scope

OpenAPI: [api.spice.ai/openapi.json](https://api.spice.ai/openapi.json)