--- title: Get Queue --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Queues](https://developers.cloudflare.com/api/go/resources/queues) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get Queue client.Queues.Get(ctx, queueID, query) (\*[Queue](), error) GET/accounts/{account\_id}/queues/{queue\_id} Returns details about a specific Queue. ##### 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 queueID string A Resource identifier. maxLength32 [Link to this property](<#(resource)%20queues%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20queue_id%20%3E%20(schema)>)

query QueueGetParams

AccountID param.Field\[string] A Resource identifier. maxLength32 Link to this property

[Link to this property](<#(resource)%20queues%20%3E%20(method)%20get%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse

type Queue struct{…}

Consumers \[]ConsumerOptional

One of the following:

type ConsumerMqWorkerConsumerResponse struct{…}

ConsumerID stringOptional A Resource identifier. maxLength32 Link to this property CreatedOn TimeOptional formatdate-time Link to this property DeadLetterQueue stringOptional Name of the dead letter queue, or empty string if not configured Link to this property QueueName stringOptional Link to this property ScriptName stringOptional Name of a Worker Link to this property

Settings ConsumerMqWorkerConsumerResponseSettingsOptional

BatchSize float64Optional The maximum number of messages to include in a batch. Link to this property MaxConcurrency float64Optional Maximum number of concurrent consumers that may consume from this Queue. Set to null to automatically opt in to the platform’s maximum (recommended). Link to this property MaxRetries float64Optional The maximum number of retries Link to this property MaxWaitTimeMs float64Optional The number of milliseconds to wait for a batch to fill up before attempting to deliver it Link to this property RetryDelay float64Optional The number of seconds to delay before making the message available for another attempt. Link to this property

Link to this property Type ConsumerMqWorkerConsumerResponseTypeOptional Link to this property

Link to this property

type ConsumerMqHTTPConsumerResponse struct{…}

Settings ConsumerMqHTTPConsumerResponseSettingsOptional

BatchSize float64Optional The maximum number of messages to include in a batch. Link to this property MaxRetries float64Optional The maximum number of retries Link to this property RetryDelay float64Optional The number of seconds to delay before making the message available for another attempt. Link to this property VisibilityTimeoutMs float64Optional The number of milliseconds that a message is exclusively leased. After the timeout, the message becomes available for another attempt. Link to this property

Link to this property Type ConsumerMqHTTPConsumerResponseTypeOptional Link to this property

Link to this property

Link to this property ConsumersTotalCount float64Optional Link to this property CreatedOn stringOptional Link to this property

Jurisdiction QueueJurisdictionOptional

One of the following: const QueueJurisdictionEu QueueJurisdiction = "eu" Link to this property const QueueJurisdictionUs QueueJurisdiction = "us" Link to this property const QueueJurisdictionFedramp QueueJurisdiction = "fedramp" Link to this property

Link to this property ModifiedOn stringOptional Link to this property

Producers \[]QueueProducerOptional

One of the following:

type QueueProducersMqWorkerProducer struct{…}

Script stringOptional Link to this property Type QueueProducersMqWorkerProducerTypeOptional Link to this property

Link to this property

type QueueProducersMqR2Producer struct{…}

BucketName stringOptional Link to this property Type QueueProducersMqR2ProducerTypeOptional Link to this property

Link to this property

Link to this property ProducersTotalCount float64Optional Link to this property QueueID stringOptional Link to this property QueueName stringOptional Link to this property

Settings QueueSettingsOptional

DeliveryDelay float64Optional Number of seconds to delay delivery of all messages to consumers. Link to this property DeliveryPaused boolOptional Indicates if message delivery to consumers is currently paused. Link to this property MessageRetentionPeriod float64Optional Number of seconds after which an unconsumed message will be delayed. Link to this property

Link to this property

[Link to this property](<#(resource)%20queues%20%3E%20(model)%20queue%20%3E%20(schema)>) ### Get Queue 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"), ) queue, err := client.Queues.Get( context.TODO(), "023e105f4ecef8ad9ca31a8372d0c353", queues.QueueGetParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", queue.QueueID) } ``` 200 example ``` { "errors": [ { "code": 7003, "message": "No route for the URI", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ "string" ], "result": { "consumers": [ { "consumer_id": "023e105f4ecef8ad9ca31a8372d0c353", "created_on": "2019-12-27T18:11:19.117Z", "dead_letter_queue": "dead_letter_queue", "queue_name": "example-queue", "script_name": "my-consumer-worker", "settings": { "batch_size": 50, "max_concurrency": 10, "max_retries": 3, "max_wait_time_ms": 5000, "retry_delay": 10 }, "type": "worker" } ], "consumers_total_count": 0, "created_on": "created_on", "jurisdiction": "eu", "modified_on": "modified_on", "producers": [ { "script": "script", "type": "worker" } ], "producers_total_count": 0, "queue_id": "queue_id", "queue_name": "example-queue", "settings": { "delivery_delay": 5, "delivery_paused": true, "message_retention_period": 345600 } }, "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": { "consumers": [ { "consumer_id": "023e105f4ecef8ad9ca31a8372d0c353", "created_on": "2019-12-27T18:11:19.117Z", "dead_letter_queue": "dead_letter_queue", "queue_name": "example-queue", "script_name": "my-consumer-worker", "settings": { "batch_size": 50, "max_concurrency": 10, "max_retries": 3, "max_wait_time_ms": 5000, "retry_delay": 10 }, "type": "worker" } ], "consumers_total_count": 0, "created_on": "created_on", "jurisdiction": "eu", "modified_on": "modified_on", "producers": [ { "script": "script", "type": "worker" } ], "producers_total_count": 0, "queue_id": "queue_id", "queue_name": "example-queue", "settings": { "delivery_delay": 5, "delivery_paused": true, "message_retention_period": 345600 } }, "success": true } ```