--- title: List account or zone routing rules --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Email Routing](https://developers.cloudflare.com/api/go/resources/email_routing) [Account Rules](https://developers.cloudflare.com/api/go/resources/email_routing/subresources/account_rules) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List account or zone routing rules client.EmailRouting.AccountRules.List(ctx, params) (\*V4PagePaginationArray\[[AccountRule]()], error) 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
params AccountRuleListParams AccountID param.Field\[string]Optional Path param: The Account ID to use for this endpoint. Mutually exclusive with the Zone ID. Link to this property ZoneID param.Field\[string]Optional Path param: The Zone ID to use for this endpoint. Mutually exclusive with the Account ID. Link to this property
Enabled param.Field\[AccountRuleListParamsEnabled]Optional Query param: Filter by enabled routing rules. const AccountRuleListParamsEnabledTrue AccountRuleListParamsEnabled = true Link to this property const AccountRuleListParamsEnabledFalse AccountRuleListParamsEnabled = false Link to this property
Link to this property Page param.Field\[float64]Optional Query param: Page number of paginated results. minimum1 Link to this property PerPage param.Field\[float64]Optional Query param: Maximum number of results per page. maximum50 minimum5 Link to this property
[Link to this property](<#(resource)%20email_routing.account_rules%20%3E%20(method)%20list%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type AccountRule struct{…} ID stringOptional Routing rule identifier. maxLength32 Link to this property
Actions \[]ActionOptional List actions patterns.
Type ActionType Type of supported action. One of the following: const ActionTypeDrop ActionType = "drop" Link to this property const ActionTypeForward ActionType = "forward" Link to this property const ActionTypeWorker ActionType = "worker" Link to this property
Link to this property Value \[]stringOptional List of values for the action. Currently limited to a single value. Link to this property
Link to this property
Enabled AccountRuleEnabledOptional Routing rule status. One of the following: const AccountRuleEnabledTrue AccountRuleEnabled = true Link to this property const AccountRuleEnabledFalse AccountRuleEnabled = false Link to this property
Link to this property
Matchers \[]MatcherOptional Matching patterns to forward to your actions.
Type MatcherType Type of matcher. One of the following: const MatcherTypeAll MatcherType = "all" Link to this property const MatcherTypeLiteral MatcherType = "literal" Link to this property
Link to this property Field MatcherFieldOptional Field for type matcher. Link to this property Value stringOptional Value for matcher. maxLength90 Link to this property
Link to this property Name stringOptional Routing rule name. maxLength256 Link to this property Priority float64Optional Priority of the routing rule. minimum0 Link to this property
Source AccountRuleSourceOptional 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: const AccountRuleSourceAPI AccountRuleSource = "api" Link to this property const AccountRuleSourceWrangler AccountRuleSource = "wrangler" Link to this property
Link to this property DeprecatedTag stringOptional Routing rule tag. (Deprecated, replaced by routing rule identifier) maxLength32 Link to this property
Zone AccountRuleZoneOptional Zone information for the routing rule. Name stringOptional Zone name. Link to this property Tag stringOptional 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 Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/email_routing" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) page, err := client.EmailRouting.AccountRules.List(context.TODO(), email_routing.AccountRuleListParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", page) } ``` 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 } } ```