List queues

Last updated Aug 20, 2026

GET /spools/{spool}/queues

One name-ordered page of the spool's queues, each with its settings and a snapshot of its depths. Keyset pagination: a paged walk never duplicates or skips a queue that exists throughout it, but counts, settings, and membership may drift between pages; counts are a snapshot, not a live read.

Sample

curl -X GET "$SPOOLER_API/spools/<spool>/queues" \
  -H "Authorization: Bearer $SPOOLER_KEY"

Parameters

Name	In	Type	Required	Description
spool	path	IdentName, 1–64 chars, ^[A-Za-z0-9_:-]+$	yes	The spool name.
limit	query	integer, 1–1,000, default 100	no	Max queues per page.
after	query	IdentName, 1–64 chars, ^[A-Za-z0-9_:-]+$	no	Resume the listing just past this queue name (the previous page's next cursor); absent starts at the first queue.
match	query	string	no	Keep only queue names matching this RE2 regular expression, unanchored (anchor with ^ and $ for an exact match); absent lists everything. Pagination walks matching names only.

Responses

Status	Description
200	One page of the spool's queues.
400	The request is malformed; the kind names the problem.
401	The API key is missing or not recognized.
402	The account is suspended.
403	A plan limit refuses the operation; the kind names it.
404	The spool or queue does not exist; the kind says which.
429	The per-account request rate cap is exceeded; retry after the Retry-After delay.
503	The spool is momentarily unavailable.

429 headers

Header	Description
Retry-After	Seconds until the next request is admitted.