--- title: List dynamic routes --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [AI Gateway](https://developers.cloudflare.com/api/go/resources/ai_gateway) [Dynamic Routing](https://developers.cloudflare.com/api/go/resources/ai_gateway/subresources/dynamic_routing) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List dynamic routes client.AIGateway.DynamicRouting.List(ctx, gatewayID, params) (\*[DynamicRoutingListResponse](), error) GET/accounts/{account\_id}/ai-gateway/gateways/{gateway\_id}/routes Lists the dynamic routes configured on an AI Gateway. ##### 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) `AI Gateway Write``AI Gateway Read` ##### ParametersExpand Collapse gatewayID string [Link to this property](<#(resource)%20ai_gateway.dynamic_routing%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20gateway_id%20%3E%20(schema)>)

params DynamicRoutingListParams

AccountID param.Field\[string] Path param Link to this property Page param.Field\[int64]Optional Query param: Page number Link to this property PerPage param.Field\[int64]Optional Query param: Number of routes per page Link to this property

[Link to this property](<#(resource)%20ai_gateway.dynamic_routing%20%3E%20(method)%20list%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse

type DynamicRoutingListResponse struct{…}

Data DynamicRoutingListResponseData

OrderBy string Link to this property OrderByDirection string Link to this property Page float64 Link to this property PerPage float64 Link to this property

Routes \[]DynamicRoutingListResponseDataRoute

ID string Link to this property AccountTag string Link to this property CreatedAt Time formatdate-time Link to this property

Deployment DynamicRoutingListResponseDataRoutesDeployment

CreatedAt string Link to this property DeploymentID string Link to this property VersionID string Link to this property

Link to this property

Elements \[]DynamicRoutingListResponseDataRoutesElement

One of the following:

type DynamicRoutingListResponseDataRoutesElementsObject struct{…}

ID string Link to this property

Outputs DynamicRoutingListResponseDataRoutesElementsObjectOutputs

Next DynamicRoutingListResponseDataRoutesElementsObjectOutputsNext

ElementID string Link to this property

Link to this property

Link to this property Type DynamicRoutingListResponseDataRoutesElementsObjectType Link to this property

Link to this property

type DynamicRoutingListResponseDataRoutesElementsObject struct{…}

ID string Link to this property

Outputs DynamicRoutingListResponseDataRoutesElementsObjectOutputs

False DynamicRoutingListResponseDataRoutesElementsObjectOutputsFalse

ElementID string Link to this property

Link to this property

True DynamicRoutingListResponseDataRoutesElementsObjectOutputsTrue

ElementID string Link to this property

Link to this property

Properties DynamicRoutingListResponseDataRoutesElementsObjectProperties

Conditions unknownOptional Link to this property

Link to this property Type DynamicRoutingListResponseDataRoutesElementsObjectType Link to this property

Link to this property

type DynamicRoutingListResponseDataRoutesElementsObject struct{…}

ID string Link to this property

Outputs map\[string, DynamicRoutingListResponseDataRoutesElementsObjectOutput]

ElementID string Link to this property

Link to this property Type DynamicRoutingListResponseDataRoutesElementsObjectType Link to this property

Link to this property

type DynamicRoutingListResponseDataRoutesElementsObject struct{…}

ID string Link to this property

Outputs DynamicRoutingListResponseDataRoutesElementsObjectOutputs

Fallback DynamicRoutingListResponseDataRoutesElementsObjectOutputsFallback

ElementID string Link to this property

Link to this property

Success DynamicRoutingListResponseDataRoutesElementsObjectOutputsSuccess

ElementID string Link to this property

Link to this property

Properties DynamicRoutingListResponseDataRoutesElementsObjectProperties

Key string Link to this property Limit float64 Link to this property

LimitType DynamicRoutingListResponseDataRoutesElementsObjectPropertiesLimitType

One of the following: const DynamicRoutingListResponseDataRoutesElementsObjectPropertiesLimitTypeCount DynamicRoutingListResponseDataRoutesElementsObjectPropertiesLimitType = "count" Link to this property const DynamicRoutingListResponseDataRoutesElementsObjectPropertiesLimitTypeCost DynamicRoutingListResponseDataRoutesElementsObjectPropertiesLimitType = "cost" Link to this property

Link to this property Window float64 Link to this property

Link to this property Type DynamicRoutingListResponseDataRoutesElementsObjectType Link to this property

Link to this property

type DynamicRoutingListResponseDataRoutesElementsObject struct{…}

ID string Link to this property

Outputs DynamicRoutingListResponseDataRoutesElementsObjectOutputs

Fallback DynamicRoutingListResponseDataRoutesElementsObjectOutputsFallback

ElementID string Link to this property

Link to this property

Success DynamicRoutingListResponseDataRoutesElementsObjectOutputsSuccess

ElementID string Link to this property

Link to this property

Properties DynamicRoutingListResponseDataRoutesElementsObjectProperties

Model string Link to this property Provider string Link to this property Retries float64 Link to this property Timeout float64 Link to this property

Link to this property Type DynamicRoutingListResponseDataRoutesElementsObjectType Link to this property

Link to this property

type DynamicRoutingListResponseDataRoutesElementsObject struct{…}

ID string Link to this property

Outputs map\[string, DynamicRoutingListResponseDataRoutesElementsObjectOutput]

ElementID string Link to this property

Link to this property Type DynamicRoutingListResponseDataRoutesElementsObjectType Link to this property

Link to this property

Link to this property GatewayID string Link to this property ModifiedAt Time formatdate-time Link to this property Name string minLength1 Link to this property

Version DynamicRoutingListResponseDataRoutesVersion

Active DynamicRoutingListResponseDataRoutesVersionActive

One of the following: const DynamicRoutingListResponseDataRoutesVersionActiveTrue DynamicRoutingListResponseDataRoutesVersionActive = "true" Link to this property const DynamicRoutingListResponseDataRoutesVersionActiveFalse DynamicRoutingListResponseDataRoutesVersionActive = "false" Link to this property

Link to this property CreatedAt string Link to this property Data string Link to this property VersionID string Link to this property IsValid boolOptional Link to this property

Link to this property

Link to this property Success bool Link to this property

[Link to this property](<#(resource)%20ai_gateway.dynamic_routing%20%3E%20(model)%20DynamicRoutingListResponse%20%3E%20(schema)>) ### List dynamic routes Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/ai_gateway" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) dynamicRoutings, err := client.AIGateway.DynamicRouting.List( context.TODO(), "54442216", ai_gateway.DynamicRoutingListParams{ AccountID: cloudflare.F("0d37909e38d3e99c29fa2cd343ac421a"), }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", dynamicRoutings.Data) } ``` 200 example ``` { "data": { "order_by": "order_by", "order_by_direction": "order_by_direction", "page": 0, "per_page": 0, "routes": [ { "id": "id", "account_tag": "account_tag", "created_at": "2019-12-27T18:11:19.117Z", "deployment": { "created_at": "created_at", "deployment_id": "deployment_id", "version_id": "version_id" }, "elements": [ { "id": "id", "outputs": { "next": { "elementId": "elementId" } }, "type": "start" } ], "gateway_id": "gateway_id", "modified_at": "2019-12-27T18:11:19.117Z", "name": "x", "version": { "active": "true", "created_at": "created_at", "data": "data", "version_id": "version_id", "is_valid": true } } ] }, "success": true } ``` ##### Returns Examples 200 example ``` { "data": { "order_by": "order_by", "order_by_direction": "order_by_direction", "page": 0, "per_page": 0, "routes": [ { "id": "id", "account_tag": "account_tag", "created_at": "2019-12-27T18:11:19.117Z", "deployment": { "created_at": "created_at", "deployment_id": "deployment_id", "version_id": "version_id" }, "elements": [ { "id": "id", "outputs": { "next": { "elementId": "elementId" } }, "type": "start" } ], "gateway_id": "gateway_id", "modified_at": "2019-12-27T18:11:19.117Z", "name": "x", "version": { "active": "true", "created_at": "created_at", "data": "data", "version_id": "version_id", "is_valid": true } } ] }, "success": true } ```