--- title: List Event Subscriptions --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Queues](https://developers.cloudflare.com/api/go/resources/queues) [Subscriptions](https://developers.cloudflare.com/api/go/resources/queues/subresources/subscriptions) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List Event Subscriptions client.Queues.Subscriptions.List(ctx, params) (\*V4PagePaginationArray\[[SubscriptionListResponse]()], error) 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
params SubscriptionListParams AccountID param.Field\[string] Path param: A Resource identifier. maxLength32 Link to this property
Direction param.Field\[SubscriptionListParamsDirection]Optional Query param: Sort direction const SubscriptionListParamsDirectionAsc SubscriptionListParamsDirection = "asc" Link to this property const SubscriptionListParamsDirectionDesc SubscriptionListParamsDirection = "desc" Link to this property
Link to this property
Order param.Field\[SubscriptionListParamsOrder]Optional Query param: Field to sort by const SubscriptionListParamsOrderCreatedAt SubscriptionListParamsOrder = "created\_at" Link to this property const SubscriptionListParamsOrderName SubscriptionListParamsOrder = "name" Link to this property const SubscriptionListParamsOrderEnabled SubscriptionListParamsOrder = "enabled" Link to this property const SubscriptionListParamsOrderSource SubscriptionListParamsOrder = "source" Link to this property
Link to this property Page param.Field\[int64]Optional Query param: Page number for pagination minimum1 Link to this property PerPage param.Field\[int64]Optional Query param: Number of items per page maximum100 minimum1 Link to this property
[Link to this property](<#(resource)%20queues.subscriptions%20%3E%20(method)%20list%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type SubscriptionListResponse struct{…} ID string Unique identifier for the subscription Link to this property CreatedAt Time When the subscription was created formatdate-time Link to this property
Destination SubscriptionListResponseDestination Destination configuration for the subscription QueueID string ID of the target queue Link to this property Type SubscriptionListResponseDestinationType Type of destination Link to this property
Link to this property Enabled bool Whether the subscription is active Link to this property Events \[]string List of event types this subscription handles Link to this property ModifiedAt Time When the subscription was last modified formatdate-time Link to this property Name string Name of the subscription Link to this property
Source SubscriptionListResponseSource Source configuration for the subscription One of the following:
type SubscriptionListResponseSourceMqEventSourceImages struct{…} Type SubscriptionListResponseSourceMqEventSourceImagesTypeOptional Type of source Link to this property
Link to this property
type SubscriptionListResponseSourceMqEventSourceKV struct{…} Type SubscriptionListResponseSourceMqEventSourceKVTypeOptional Type of source Link to this property
Link to this property
type SubscriptionListResponseSourceMqEventSourceR2 struct{…} Type SubscriptionListResponseSourceMqEventSourceR2TypeOptional Type of source Link to this property
Link to this property
type SubscriptionListResponseSourceMqEventSourceSuperSlurper struct{…} Type SubscriptionListResponseSourceMqEventSourceSuperSlurperTypeOptional Type of source Link to this property
Link to this property
type SubscriptionListResponseSourceMqEventSourceVectorize struct{…} Type SubscriptionListResponseSourceMqEventSourceVectorizeTypeOptional Type of source Link to this property
Link to this property
type SubscriptionListResponseSourceMqEventSourceWorkersAIModel struct{…} ModelName stringOptional Name of the Workers AI model Link to this property Type SubscriptionListResponseSourceMqEventSourceWorkersAIModelTypeOptional Type of source Link to this property
Link to this property
type SubscriptionListResponseSourceMqEventSourceWorkersBuildsWorker struct{…} Type SubscriptionListResponseSourceMqEventSourceWorkersBuildsWorkerTypeOptional Type of source Link to this property WorkerName stringOptional Name of the worker Link to this property
Link to this property
type SubscriptionListResponseSourceMqEventSourceWorkersScript struct{…} ScriptTag stringOptional Tag of the Worker script Link to this property Type SubscriptionListResponseSourceMqEventSourceWorkersScriptTypeOptional Type of source Link to this property
Link to this property
type SubscriptionListResponseSourceMqEventSourceWorkflowsWorkflow struct{…} Type SubscriptionListResponseSourceMqEventSourceWorkflowsWorkflowTypeOptional Type of source Link to this property WorkflowName stringOptional 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)%20SubscriptionListResponse%20%3E%20(schema)>) ### List Event Subscriptions Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/queues" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) page, err := client.Queues.Subscriptions.List(context.TODO(), queues.SubscriptionListParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", page) } ``` 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 } ```