--- title: List DLS regions for an account --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Data Localization Suite](https://developers.cloudflare.com/api/python/resources/dls) [Regions](https://developers.cloudflare.com/api/python/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 dls.regions.list(RegionListParams\*\*kwargs) -> SyncCursorPagination\[[RegionListResponse]()] 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
##### ParametersExpand Collapse account\_id: str 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)>) cursor: Optional\[str] 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\[int] 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\[Literal\["managed", "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
class RegionListResponse: … id: str Link to this property created\_on: datetime formatdate-time Link to this property modified\_on: datetime formatdate-time Link to this property name: str Link to this property region\_key: str maxLength128 minLength1 Link to this property version: int Link to this property version\_created\_on: datetime formatdate-time Link to this property
[Link to this property](<#(resource)%20dls.regions%20%3E%20(model)%20region_list_response%20%3E%20(schema)>) ### List DLS regions for an account Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) page = client.dls.regions.list( account_id="023e105f4ecef8ad9ca31a8372d0c353", ) page = page.result[0] print(page.id) ``` 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 } ```