---
title: List dynamic route versions
---

[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 route versions

ai\_gateway.dynamic\_routing.list\_versions(strid, DynamicRoutingListVersionsParams\*\*kwargs) -> [DynamicRoutingListVersionsResponse](<https://developers.cloudflare.com/api/python/resources/ai_gateway#(resource)%20ai_gateway.dynamic_routing%20%3E%20(model)%20dynamic_routing_list_versions_response%20%3E%20(schema)>)

GET/accounts/{account\_id}/ai-gateway/gateways/{gateway\_id}/routes/{id}/versions

Lists the saved versions of a dynamic route.

##### Security

<details>

<summary>API Token</summary>



The preferred authorization scheme for interacting with the Cloudflare API. <a href="https://developers.cloudflare.com/fundamentals/api/get-started/create-token/">Create a token</a>.

**Example:**<code>Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY</code>

</details>

<details>

<summary>API Email + API Key</summary>



The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

**Example:**<code>X-Auth-Email: user@example.com</code>

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

**Example:**<code>X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194</code>

</details>

##### 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_versions%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_versions%20%3E%20(params)%20default%20%3E%20(param)%20gateway_id%20%3E%20(schema)>)

id: str

[Link to this property](<#(resource)%20ai_gateway.dynamic_routing%20%3E%20(method)%20list_versions%20%3E%20(params)%20default%20%3E%20(param)%20id%20%3E%20(schema)>)

##### ReturnsExpand Collapse

<details>

<summary>

class DynamicRoutingListVersionsResponse: …

</summary>

<details>

<summary>

data: Data

</summary>

order\_by: str

<a href="#(resource)%20ai_gateway.dynamic_routing%20%3E%20(model)%20dynamic_routing_list_versions_response%20%3E%20(schema)%20%3E%20(property)%20data%20%3E%20(property)%20order_by">Link to this property</a>

order\_by\_direction: str

<a href="#(resource)%20ai_gateway.dynamic_routing%20%3E%20(model)%20dynamic_routing_list_versions_response%20%3E%20(schema)%20%3E%20(property)%20data%20%3E%20(property)%20order_by_direction">Link to this property</a>

page: float

<a href="#(resource)%20ai_gateway.dynamic_routing%20%3E%20(model)%20dynamic_routing_list_versions_response%20%3E%20(schema)%20%3E%20(property)%20data%20%3E%20(property)%20page">Link to this property</a>

per\_page: float

<a href="#(resource)%20ai_gateway.dynamic_routing%20%3E%20(model)%20dynamic_routing_list_versions_response%20%3E%20(schema)%20%3E%20(property)%20data%20%3E%20(property)%20per_page">Link to this property</a>

<details>

<summary>

versions: List\[DataVersion]

</summary>

<details>

<summary>

active: Literal\["true", "false"]

</summary>

One of the following:

"true"

<a href="#(resource)%20ai_gateway.dynamic_routing%20%3E%20(model)%20dynamic_routing_list_versions_response%20%3E%20(schema)%20%3E%20(property)%20data%20%3E%20(property)%20versions%20%3E%20(items)%20%3E%20(property)%20active%20%3E%20(member)%200">Link to this property</a>

"false"

<a href="#(resource)%20ai_gateway.dynamic_routing%20%3E%20(model)%20dynamic_routing_list_versions_response%20%3E%20(schema)%20%3E%20(property)%20data%20%3E%20(property)%20versions%20%3E%20(items)%20%3E%20(property)%20active%20%3E%20(member)%201">Link to this property</a>

</details>

<a href="#(resource)%20ai_gateway.dynamic_routing%20%3E%20(model)%20dynamic_routing_list_versions_response%20%3E%20(schema)%20%3E%20(property)%20data%20%3E%20(property)%20versions%20%3E%20(items)%20%3E%20(property)%20active">Link to this property</a>

created\_at: str

<a href="#(resource)%20ai_gateway.dynamic_routing%20%3E%20(model)%20dynamic_routing_list_versions_response%20%3E%20(schema)%20%3E%20(property)%20data%20%3E%20(property)%20versions%20%3E%20(items)%20%3E%20(property)%20created_at">Link to this property</a>

data: str

<a href="#(resource)%20ai_gateway.dynamic_routing%20%3E%20(model)%20dynamic_routing_list_versions_response%20%3E%20(schema)%20%3E%20(property)%20data%20%3E%20(property)%20versions%20%3E%20(items)%20%3E%20(property)%20data">Link to this property</a>

version\_id: str

<a href="#(resource)%20ai_gateway.dynamic_routing%20%3E%20(model)%20dynamic_routing_list_versions_response%20%3E%20(schema)%20%3E%20(property)%20data%20%3E%20(property)%20versions%20%3E%20(items)%20%3E%20(property)%20version_id">Link to this property</a>

is\_valid: Optional\[bool]

<a href="#(resource)%20ai_gateway.dynamic_routing%20%3E%20(model)%20dynamic_routing_list_versions_response%20%3E%20(schema)%20%3E%20(property)%20data%20%3E%20(property)%20versions%20%3E%20(items)%20%3E%20(property)%20is_valid">Link to this property</a>

</details>

<a href="#(resource)%20ai_gateway.dynamic_routing%20%3E%20(model)%20dynamic_routing_list_versions_response%20%3E%20(schema)%20%3E%20(property)%20data%20%3E%20(property)%20versions">Link to this property</a>

</details>

<a href="#(resource)%20ai_gateway.dynamic_routing%20%3E%20(model)%20dynamic_routing_list_versions_response%20%3E%20(schema)%20%3E%20(property)%20data">Link to this property</a>

success: bool

<a href="#(resource)%20ai_gateway.dynamic_routing%20%3E%20(model)%20dynamic_routing_list_versions_response%20%3E%20(schema)%20%3E%20(property)%20success">Link to this property</a>

</details>

[Link to this property](<#(resource)%20ai_gateway.dynamic_routing%20%3E%20(model)%20dynamic_routing_list_versions_response%20%3E%20(schema)>)

### List dynamic route versions

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
)
response = client.ai_gateway.dynamic_routing.list_versions(
    id="54442216",
    account_id="0d37909e38d3e99c29fa2cd343ac421a",
    gateway_id="54442216",
)
print(response.data)
```

200 example

```
{
  "data": {
    "order_by": "order_by",
    "order_by_direction": "order_by_direction",
    "page": 0,
    "per_page": 0,
    "versions": [
      {
        "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,
    "versions": [
      {
        "active": "true",
        "created_at": "created_at",
        "data": "data",
        "version_id": "version_id",
        "is_valid": true
      }
    ]
  },
  "success": true
}
```