--- title: List Event Subscriptions --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Queues](https://developers.cloudflare.com/api/python/resources/queues) [Subscriptions](https://developers.cloudflare.com/api/python/resources/queues/subresources/subscriptions) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List Event Subscriptions queues.subscriptions.list(SubscriptionListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[SubscriptionListResponse]()] GET/accounts/{account\_id}/event\_subscriptions/subscriptions Returns a paginated list of Queue event subscriptions with optional sorting and filtering. ##### 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) `Queues Write``Queues Read``Workers Scripts Write``Workers Scripts Read` ##### ParametersExpand Collapse account\_id: str A Resource identifier. maxLength32 [Link to this property](<#(resource)%20queues.subscriptions%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>)
direction: Optional\[Literal\["asc", "desc"]] Sort direction One of the following: "asc" Link to this property "desc" Link to this property
[Link to this property](<#(resource)%20queues.subscriptions%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20direction%20%3E%20(schema)>)
order: Optional\[Literal\["created\_at", "name", "enabled", "source"]] Field to sort by One of the following: "created\_at" Link to this property "name" Link to this property "enabled" Link to this property "source" Link to this property
[Link to this property](<#(resource)%20queues.subscriptions%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20order%20%3E%20(schema)>) page: Optional\[int] Page number for pagination minimum1 [Link to this property](<#(resource)%20queues.subscriptions%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 items per page maximum100 minimum1 [Link to this property](<#(resource)%20queues.subscriptions%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class SubscriptionListResponse: … id: str Unique identifier for the subscription Link to this property created\_at: datetime When the subscription was created formatdate-time Link to this property
destination: Destination Destination configuration for the subscription queue\_id: str ID of the target queue Link to this property type: Literal\["queues.queue"] Type of destination Link to this property
Link to this property enabled: bool Whether the subscription is active Link to this property events: List\[str] List of event types this subscription handles Link to this property modified\_at: datetime When the subscription was last modified formatdate-time Link to this property name: str Name of the subscription Link to this property
source: Source Source configuration for the subscription One of the following:
class SourceMqEventSourceImages: … type: Optional\[Literal\["images"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceKV: … type: Optional\[Literal\["kv"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceR2: … type: Optional\[Literal\["r2"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceSuperSlurper: … type: Optional\[Literal\["superSlurper"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceVectorize: … type: Optional\[Literal\["vectorize"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceWorkersAIModel: … model\_name: Optional\[str] Name of the Workers AI model Link to this property type: Optional\[Literal\["workersAi.model"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceWorkersBuildsWorker: … type: Optional\[Literal\["workersBuilds.worker"]] Type of source Link to this property worker\_name: Optional\[str] Name of the worker Link to this property
Link to this property
class SourceMqEventSourceWorkersScript: … script\_tag: Optional\[str] Tag of the Worker script Link to this property type: Optional\[Literal\["workers.script"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceWorkflowsWorkflow: … type: Optional\[Literal\["workflows.workflow"]] Type of source Link to this property workflow\_name: Optional\[str] Name of the workflow Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20queues.subscriptions%20%3E%20(model)%20subscription_list_response%20%3E%20(schema)>) ### List Event Subscriptions 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.queues.subscriptions.list( account_id="023e105f4ecef8ad9ca31a8372d0c353", ) page = page.result[0] print(page.id) ``` 200 example ``` { "errors": [ { "code": 7003, "message": "No route for the URI", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ "string" ], "result": [ { "id": "id", "created_at": "2019-12-27T18:11:19.117Z", "destination": { "queue_id": "queue_id", "type": "queues.queue" }, "enabled": true, "events": [ "string" ], "modified_at": "2019-12-27T18:11:19.117Z", "name": "name", "source": { "type": "images" } } ], "result_info": { "count": 0, "page": 0, "per_page": 0, "total_count": 0, "total_pages": 0 }, "success": true } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 7003, "message": "No route for the URI", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ "string" ], "result": [ { "id": "id", "created_at": "2019-12-27T18:11:19.117Z", "destination": { "queue_id": "queue_id", "type": "queues.queue" }, "enabled": true, "events": [ "string" ], "modified_at": "2019-12-27T18:11:19.117Z", "name": "name", "source": { "type": "images" } } ], "result_info": { "count": 0, "page": 0, "per_page": 0, "total_count": 0, "total_pages": 0 }, "success": true } ```