--- title: List account or zone routing rules --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Email Routing](https://developers.cloudflare.com/api/python/resources/email_routing) [Rules](https://developers.cloudflare.com/api/python/resources/email_routing/subresources/rules) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List account or zone routing rules email\_routing.rules.list(RuleListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[AccountRule]()] GET/{accounts\_or\_zones}/{account\_or\_zone\_id}/email/routing/rules Lists existing routing rules across all zones in the account or zone. ##### 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: Optional\[str] The Account ID to use for this endpoint. Mutually exclusive with the Zone ID. [Link to this property](<#(resource)%20email_routing.rules%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) zone\_id: Optional\[str] The Zone ID to use for this endpoint. Mutually exclusive with the Account ID. [Link to this property](<#(resource)%20email_routing.rules%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20zone_id%20%3E%20(schema)>)
enabled: Optional\[Literal\[true, false]] Filter by enabled routing rules. One of the following: true Link to this property false Link to this property
[Link to this property](<#(resource)%20email_routing.rules%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20enabled%20%3E%20(schema)>) page: Optional\[float] Page number of paginated results. minimum1 [Link to this property](<#(resource)%20email_routing.rules%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.rules%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class AccountRule: … id: Optional\[str] Routing rule identifier. maxLength32 Link to this property
actions: Optional\[List\[Action]] List actions patterns.
type: Literal\["drop", "forward", "worker"] Type of supported action. One of the following: "drop" Link to this property "forward" Link to this property "worker" Link to this property
Link to this property value: Optional\[List\[str]] List of values for the action. Currently limited to a single value. Link to this property
Link to this property
enabled: Optional\[Literal\[true, false]] Routing rule status. One of the following: true Link to this property false Link to this property
Link to this property
matchers: Optional\[List\[Matcher]] Matching patterns to forward to your actions.
type: Literal\["all", "literal"] Type of matcher. One of the following: "all" Link to this property "literal" Link to this property
Link to this property field: Optional\[Literal\["to"]] Field for type matcher. Link to this property value: Optional\[str] Value for matcher. maxLength90 Link to this property
Link to this property name: Optional\[str] Routing rule name. maxLength256 Link to this property priority: Optional\[float] Priority of the routing rule. minimum0 Link to this property
source: Optional\[Literal\["api", "wrangler"]] Who manages the rule. api covers dashboard, generic API, and Terraform; wrangler means the rule is managed by a Worker’s wrangler.jsonc. Defaults to api when omitted on write. One of the following: "api" Link to this property "wrangler" Link to this property
Link to this property Deprecatedtag: Optional\[str] Routing rule tag. (Deprecated, replaced by routing rule identifier) maxLength32 Link to this property
zone: Optional\[Zone] Zone information for the routing rule. name: Optional\[str] Zone name. Link to this property tag: Optional\[str] Zone tag. maxLength32 Link to this property
Link to this property
[Link to this property](<#(resource)%20email_routing.account_rules%20%3E%20(model)%20account_rule%20%3E%20(schema)>) ### List account or zone routing rules 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.rules.list( account_id="account_id", ) 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": "a7e6fb77503c41d8a7f3113c6918f10c", "actions": [ { "type": "forward", "value": [ "destinationaddress@example.net" ] } ], "enabled": true, "matchers": [ { "type": "literal", "field": "to", "value": "test@example.com" } ], "name": "Send to user@example.net rule.", "priority": 0, "source": "api", "tag": "a7e6fb77503c41d8a7f3113c6918f10c", "zone": { "name": "example.com", "tag": "023e105f4ecef8ad9ca31a8372d0c353" } } ], "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": "a7e6fb77503c41d8a7f3113c6918f10c", "actions": [ { "type": "forward", "value": [ "destinationaddress@example.net" ] } ], "enabled": true, "matchers": [ { "type": "literal", "field": "to", "value": "test@example.com" } ], "name": "Send to user@example.net rule.", "priority": 0, "source": "api", "tag": "a7e6fb77503c41d8a7f3113c6918f10c", "zone": { "name": "example.com", "tag": "023e105f4ecef8ad9ca31a8372d0c353" } } ], "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 1, "total_pages": 100 } } ```