---
layout: api
page_title: Regions - HTTP API
description: The /regions endpoints list all known regions.
---

# Regions HTTP API

The `/regions` endpoints list all known regions.

## List Regions

| Method | Path          | Produces           |
| ------ | ------------- | ------------------ |
| `GET`  | `/v1/regions` | `application/json` |

The table below shows this endpoint's support for
[blocking queries](/api-docs#blocking-queries) and
[required ACLs](/api-docs#acls).

| Blocking Queries | ACL Required |
| ---------------- | ------------ |
| `NO`             | `none`       |

### Sample Request

```shell-session
$ curl \
    https://localhost:4646/v1/regions
```

### Sample Response

```json
["region1", "region2"]
```