Skip to content

List jobs across all queues​

GET
/api/jobs

Browse recent jobs across all queues with filtering by queue name and status. Supports pagination via page/pageSize query params. total is the exact number of matching jobs. Browsing is bounded: every selected queue/status board is read in BullMQ's native order up to a share of a 10000-job window (fewer selected boards means a deeper per-board window), and the merged result is ordered by creation time. truncated is true when any board holds more matching jobs than the window reaches; those jobs cannot be paged to.

Parameters​

Query Parameters

queue

Filter by queue name (e.g. book-detected)

Type
string
status

Filter by job status

Type
string
Valid values
"completed""active""waiting""failed""delayed"
page

Page number

Type
integer
Minimum
1
Default
1
pageSize

Items per page (max 100)

Type
integer
Minimum
1
Maximum
100
Default
20

Responses​

Paginated list of jobs

application/json
JSON
{
  
"jobs": [
  
  
{
  
  
  
"id": "string",
  
  
  
"queueName": "string",
  
  
  
"name": "string",
  
  
  
"data": {
  
  
  
  
"additionalProperties": "string"
  
  
  
},
  
  
  
"status": "string",
  
  
  
"progress": 0,
  
  
  
"returnValue": "string",
  
  
  
"failedReason": "string",
  
  
  
"stacktrace": [
  
  
  
  
"string"
  
  
  
],
  
  
  
"attemptsMade": 0,
  
  
  
"maxAttempts": 0,
  
  
  
"timestamp": 0,
  
  
  
"processedOn": 0,
  
  
  
"finishedOn": 0,
  
  
  
"duration": 0
  
  
}
  
],
  
"total": 0,
  
"page": 0,
  
"pageSize": 0,
  
"totalPages": 0,
  
"truncated": true
}

Samples​