# Regions (/docs/reference/api/regions)



Regions [#regions]

GET `/v1/regions` [#get-v1regions]

Use a user session or OAuth access token to list regions. Omit `organization_id`
to get enabled public regions, including during onboarding. Pass an organization
UUID to get public regions and the RawTree BYOC regions available to that organization.
The caller must be a member. RawTree BYOC regions require an active Unlimited plan.

The response contains a `regions` array. The organization-scoped list includes
disabled entries. Check `enabled` before choosing a region. Deployments can
share a `cloud_region`. Use the region's `id` to select a placement.

Use a user session or user OAuth token with `full_access`. API keys and workload tokens cannot use this method.

Parameters:

| Field             | Location | Type   | Required | Notes                                                                  |
| ----------------- | -------- | ------ | -------- | ---------------------------------------------------------------------- |
| `organization_id` | query    | string | No       | Include regions owned by this organization when its plan permits BYOC. |

Request:

```bash
# List regions.
curl -X GET "https://api.rawtree.com/v1/regions" \
  -H "Authorization: Bearer $RAWTREE_USER_TOKEN"
```

Expected response: **HTTP 200**.

```json
{
  "regions": [
    {
      "id": "11111111-1111-4111-8111-111111111111",
      "name": "aws-eu-west-1",
      "cloud_region": "eu-west-1",
      "enabled": true,
      "created_at": "2026-11-09T10:00:00Z",
      "updated_at": "2026-11-09T10:00:00Z",
      "organization_id": null
    }
  ]
}
```

Errors: `400`, `401`, `403`. See [API errors](/docs/reference/errors).