---
title: List DLS regions for an account
---
[Skip to content](#_top)
[API Reference](https://developers.cloudflare.com/api)
[Data Localization Suite](https://developers.cloudflare.com/api/resources/dls)
[Regions](https://developers.cloudflare.com/api/resources/dls/subresources/regions)
Copy Markdown
Open in **Claude**Open in **ChatGPT**Open in **Cursor**
---
**Copy Markdown****View as Markdown**
# List DLS regions for an account
GET/accounts/{account\_id}/dls/regions
List DLS regions for an account
##### Security
API Token
The preferred authorization scheme for interacting with the Cloudflare API. Create a token.
**Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key
The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.
**Example:**X-Auth-Email: user@example.com
The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.
**Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### P ath ParametersExpand Collapse
account\_id: string
Identifier of a Cloudflare account.
maxLength32
minLength32
[Link to this property](<#(resource)%20dls.regions%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>)
##### Q uery ParametersExpand Collapse
cursor: optional string
Opaque token for cursor-based pagination. Omit for the first page. Pass the value from a previous response to fetch the next page.
[Link to this property](<#(resource)%20dls.regions%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20cursor%20%3E%20(schema)>)
per\_page: optional number
maximum100
minimum1
[Link to this property](<#(resource)%20dls.regions%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>)
type: optional "managed"or "custom"
Filter regions by type. Omit to return all regions.
One of the following:
"managed"
Link to this property
"custom"
Link to this property
[Link to this property](<#(resource)%20dls.regions%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20type%20%3E%20(schema)>)
##### ReturnsExpand Collapse
errors: array of ResponseInfo { code, message, documentation\_url, source }
code: number
minimum1000
Link to this property
message: string
Link to this property
documentation\_url: optional string
Link to this property
source: optional object {pointer }
pointer: optional string
Link to this property
Link to this property
[Link to this property](<#(resource)%20dls.regions%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)
messages: array of ResponseInfo { code, message, documentation\_url, source }
code: number
minimum1000
Link to this property
message: string
Link to this property
documentation\_url: optional string
Link to this property
source: optional object {pointer }
pointer: optional string
Link to this property
Link to this property
[Link to this property](<#(resource)%20dls.regions%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)
result: array of object {id, created\_on, modified\_on, 4 more }
id: string
Link to this property
created\_on: string
formatdate-time
Link to this property
modified\_on: string
formatdate-time
Link to this property
name: string
Link to this property
region\_key: string
maxLength128
minLength1
Link to this property
version: number
Link to this property
version\_created\_on: string
formatdate-time
Link to this property
[Link to this property](<#(resource)%20dls.regions%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result>)
result\_info: object {count, cursor, per\_page }
count: number
Number of items in the current page.
Link to this property
cursor: string
Opaque cursor for the next page. Empty string when there are no more results.
Link to this property
per\_page: number
Maximum number of items per page.
Link to this property
[Link to this property](<#(resource)%20dls.regions%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result_info>)
success: boolean
[Link to this property](<#(resource)%20dls.regions%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20success>)
### List DLS regions for an account
HTTP
HTTPTypeScriptPythonGoTerraform
```
curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/dls/regions \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
```
200 example
```
{
"errors": [
{
"code": 1000,
"message": "message",
"documentation_url": "documentation_url",
"source": {
"pointer": "pointer"
}
}
],
"messages": [
{
"code": 1000,
"message": "message",
"documentation_url": "documentation_url",
"source": {
"pointer": "pointer"
}
}
],
"result": [
{
"id": "id",
"created_on": "2019-12-27T18:11:19.117Z",
"modified_on": "2019-12-27T18:11:19.117Z",
"name": "name",
"region_key": "x",
"version": 0,
"version_created_on": "2019-12-27T18:11:19.117Z"
}
],
"result_info": {
"count": 0,
"cursor": "cursor",
"per_page": 0
},
"success": true
}
```
##### Returns Examples
200 example
```
{
"errors": [
{
"code": 1000,
"message": "message",
"documentation_url": "documentation_url",
"source": {
"pointer": "pointer"
}
}
],
"messages": [
{
"code": 1000,
"message": "message",
"documentation_url": "documentation_url",
"source": {
"pointer": "pointer"
}
}
],
"result": [
{
"id": "id",
"created_on": "2019-12-27T18:11:19.117Z",
"modified_on": "2019-12-27T18:11:19.117Z",
"name": "name",
"region_key": "x",
"version": 0,
"version_created_on": "2019-12-27T18:11:19.117Z"
}
],
"result_info": {
"count": 0,
"cursor": "cursor",
"per_page": 0
},
"success": true
}
```