--- title: List dynamic routes --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [AI Gateway](https://developers.cloudflare.com/api/python/resources/ai_gateway) [Dynamic Routing](https://developers.cloudflare.com/api/python/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 ai\_gateway.dynamic\_routing.list(strgateway\_id, DynamicRoutingListParams\*\*kwargs) -> [DynamicRoutingListResponse]() 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 account\_id: str [Link to this property](<#(resource)%20ai_gateway.dynamic_routing%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) gateway\_id: str [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)>) page: Optional\[int] Page number [Link to this property](<#(resource)%20ai_gateway.dynamic_routing%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20page%20%3E%20(schema)>) per\_page: Optional\[int] Number of routes per page [Link to this property](<#(resource)%20ai_gateway.dynamic_routing%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class DynamicRoutingListResponse: …
data: Data order\_by: str Link to this property order\_by\_direction: str Link to this property page: float Link to this property per\_page: float Link to this property
routes: List\[DataRoute] id: str Link to this property account\_tag: str Link to this property created\_at: datetime formatdate-time Link to this property
deployment: DataRouteDeployment created\_at: str Link to this property deployment\_id: str Link to this property version\_id: str Link to this property
Link to this property
elements: List\[DataRouteElement] One of the following:
class DataRouteElementUnionMember0: … id: str Link to this property
outputs: DataRouteElementUnionMember0Outputs
next: DataRouteElementUnionMember0OutputsNext element\_id: str Link to this property
Link to this property
Link to this property type: Literal\["start"] Link to this property
Link to this property
class DataRouteElementUnionMember1: … id: str Link to this property
outputs: DataRouteElementUnionMember1Outputs
false: DataRouteElementUnionMember1OutputsFalse\_ element\_id: str Link to this property
Link to this property
true: DataRouteElementUnionMember1OutputsTrue\_ element\_id: str Link to this property
Link to this property
Link to this property
properties: DataRouteElementUnionMember1Properties conditions: Optional\[object] Link to this property
Link to this property type: Literal\["conditional"] Link to this property
Link to this property
class DataRouteElementUnionMember2: … id: str Link to this property
outputs: Dict\[str, DataRouteElementUnionMember2Outputs] element\_id: str Link to this property
Link to this property type: Literal\["percentage"] Link to this property
Link to this property
class DataRouteElementUnionMember3: … id: str Link to this property
outputs: DataRouteElementUnionMember3Outputs
fallback: DataRouteElementUnionMember3OutputsFallback element\_id: str Link to this property
Link to this property
success: DataRouteElementUnionMember3OutputsSuccess element\_id: str Link to this property
Link to this property
Link to this property
properties: DataRouteElementUnionMember3Properties key: str Link to this property limit: float Link to this property
limit\_type: Literal\["count", "cost"] One of the following: "count" Link to this property "cost" Link to this property
Link to this property window: float Link to this property
Link to this property type: Literal\["rate"] Link to this property
Link to this property
class DataRouteElementUnionMember4: … id: str Link to this property
outputs: DataRouteElementUnionMember4Outputs
fallback: DataRouteElementUnionMember4OutputsFallback element\_id: str Link to this property
Link to this property
success: DataRouteElementUnionMember4OutputsSuccess element\_id: str Link to this property
Link to this property
Link to this property
properties: DataRouteElementUnionMember4Properties model: str Link to this property provider: str Link to this property retries: float Link to this property timeout: float Link to this property
Link to this property type: Literal\["model"] Link to this property
Link to this property
class DataRouteElementUnionMember5: … id: str Link to this property
outputs: Dict\[str, DataRouteElementUnionMember5Outputs] element\_id: str Link to this property
Link to this property type: Literal\["end"] Link to this property
Link to this property
Link to this property gateway\_id: str Link to this property modified\_at: datetime formatdate-time Link to this property name: str minLength1 Link to this property
version: DataRouteVersion
active: Literal\["true", "false"] One of the following: "true" Link to this property "false" Link to this property
Link to this property created\_at: str Link to this property data: str Link to this property version\_id: str Link to this property is\_valid: Optional\[bool] Link to this property
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)%20dynamic_routing_list_response%20%3E%20(schema)>) ### List dynamic routes 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 ) dynamic_routings = client.ai_gateway.dynamic_routing.list( gateway_id="54442216", account_id="0d37909e38d3e99c29fa2cd343ac421a", ) print(dynamic_routings.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 } ```