List Queues

GET/accounts/{account_id}/queues

Returns the queues owned by an account.

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 WriteQueues ReadWorkers Scripts WriteWorkers Scripts Read

Path ParametersExpand Collapse

account_id: string

A Resource identifier.

maxLength32

ReturnsExpand Collapse

errors: optional array of ResponseInfo { code, message, documentation_url, source }

minLength1

code: number

minimum1000

message: string

documentation_url: optional string

source: optional { pointer }

pointer: optional string

messages: optional array of string

result: optional array of Queue { consumers, consumers_total_count, created_on, 6 more }

consumers: optional array of Consumer

One of the following:

Worker { consumer_id, created_on, dead_letter_queue, 4 more }

consumer_id: optional string

A Resource identifier.

maxLength32

created_on: optional string

formatdate-time

dead_letter_queue: optional string

Name of the dead letter queue, or empty string if not configured

queue_name: optional string

script_name: optional string

Name of a Worker

settings: optional { batch_size, max_concurrency, max_retries, 2 more }

batch_size: optional number

The maximum number of messages to include in a batch.

max_concurrency: optional number

Maximum number of concurrent consumers that may consume from this Queue. Set to null to automatically opt in to the platform’s maximum (recommended).

max_retries: optional number

The maximum number of retries

max_wait_time_ms: optional number

The number of milliseconds to wait for a batch to fill up before attempting to deliver it

retry_delay: optional number

The number of seconds to delay before making the message available for another attempt.

type: optional "worker"

HTTPPull { consumer_id, created_on, dead_letter_queue, 3 more }

consumer_id: optional string

A Resource identifier.

maxLength32

created_on: optional string

formatdate-time

dead_letter_queue: optional string

Name of the dead letter queue, or empty string if not configured

queue_name: optional string

settings: optional { batch_size, max_retries, retry_delay, visibility_timeout_ms }

batch_size: optional number

The maximum number of messages to include in a batch.

max_retries: optional number

The maximum number of retries

retry_delay: optional number

The number of seconds to delay before making the message available for another attempt.

visibility_timeout_ms: optional number

The number of milliseconds that a message is exclusively leased. After the timeout, the message becomes available for another attempt.

type: optional "http_pull"

consumers_total_count: optional number

created_on: optional string

modified_on: optional string

producers: optional array of { script, type } or { bucket_name, type }

One of the following:

MqWorkerProducer { script, type }

script: optional string

type: optional "worker"

MqR2Producer { bucket_name, type }

bucket_name: optional string

type: optional "r2_bucket"

producers_total_count: optional number

queue_id: optional string

queue_name: optional string

settings: optional { delivery_delay, delivery_paused, message_retention_period }

delivery_delay: optional number

Number of seconds to delay delivery of all messages to consumers.

delivery_paused: optional boolean

Indicates if message delivery to consumers is currently paused.

message_retention_period: optional number

Number of seconds after which an unconsumed message will be delayed.

result_info: optional { count, page, per_page, 2 more }

count: optional number

Total number of queues

page: optional number

Current page within paginated list of queues

per_page: optional number

Number of queues per page

total_count: optional number

Total queues available without any search parameters

total_pages: optional number

Total pages available without any search parameters

success: optional true

Indicates if the API call was successful or not.

List Queues

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/queues \
    -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

{
  "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",
      "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
      }
    }
  ],
  "result_info": {
    "count": 1,
    "page": 1,
    "per_page": 20,
    "total_count": 2000,
    "total_pages": 100
  },
  "success": true
}

Returns Examples

{
  "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",
      "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
      }
    }
  ],
  "result_info": {
    "count": 1,
    "page": 1,
    "per_page": 20,
    "total_count": 2000,
    "total_pages": 100
  },
  "success": true
}