--- title: List destination addresses --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Email Routing](https://developers.cloudflare.com/api/python/resources/email_routing) [Addresses](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/addresses) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List destination addresses email\_routing.addresses.list(AddressListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[Address]()] GET/accounts/{account\_id}/email/routing/addresses Lists destination addresses configured for Email Routing in 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
##### Accepted Permissions (at least one required) `Email Routing Addresses Write``Email Routing Addresses Read` ##### ParametersExpand Collapse account\_id: str Identifier. maxLength32 [Link to this property](<#(resource)%20email_routing.addresses%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>)
direction: Optional\[Literal\["asc", "desc"]] Sorts results in an ascending or descending order. One of the following: "asc" Link to this property "desc" Link to this property
[Link to this property](<#(resource)%20email_routing.addresses%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20direction%20%3E%20(schema)>) page: Optional\[float] Page number of paginated results. minimum1 [Link to this property](<#(resource)%20email_routing.addresses%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20page%20%3E%20(schema)>) per\_page: Optional\[float] Maximum number of results per page. maximum50 minimum5 [Link to this property](<#(resource)%20email_routing.addresses%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>)
verified: Optional\[Literal\[true, false]] Filter by verified destination addresses. One of the following: true Link to this property false Link to this property
[Link to this property](<#(resource)%20email_routing.addresses%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20verified%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class Address: … id: Optional\[str] Destination address identifier. maxLength32 Link to this property created: Optional\[datetime] The date and time the destination address has been created. formatdate-time Link to this property email: Optional\[str] The contact email address of the user. maxLength90 Link to this property modified: Optional\[datetime] The date and time the destination address was last modified. formatdate-time Link to this property Deprecatedtag: Optional\[str] Destination address tag. (Deprecated, replaced by destination address identifier) maxLength32 Link to this property verified: Optional\[datetime] The date and time the destination address has been verified. Null means not verified yet. formatdate-time Link to this property
[Link to this property](<#(resource)%20email_routing.addresses%20%3E%20(model)%20address%20%3E%20(schema)>) ### List destination addresses 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.email_routing.addresses.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" } } ], "success": true, "result": [ { "id": "ea95132c15732412d22c1476fa83f27a", "created": "2014-01-02T02:20:00Z", "email": "user@example.com", "modified": "2014-01-02T02:20:00Z", "tag": "ea95132c15732412d22c1476fa83f27a", "verified": "2014-01-02T02:20:00Z" } ], "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 1, "total_pages": 100 } } ``` ##### 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" } } ], "success": true, "result": [ { "id": "ea95132c15732412d22c1476fa83f27a", "created": "2014-01-02T02:20:00Z", "email": "user@example.com", "modified": "2014-01-02T02:20:00Z", "tag": "ea95132c15732412d22c1476fa83f27a", "verified": "2014-01-02T02:20:00Z" } ], "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 1, "total_pages": 100 } } ```