List Failed (DLQ) Jobs

GET

https://stageapi.partake.ng/api/v2/admin/queue/{{queueName}}/failed

Last modified:2026-07-10 13:15:30

Maintainer:Not configured

List failed dead-letter jobs for the specified queue. Valid queue names: otp, notifications, file-cleanup, data-export, webhook-retry. Admin only.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

Bodyapplication/json

🟠400

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://stageapi.partake.ng/api/v2/admin/queue/{{queueName}}/failed?page=1&limit=20' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
  "success": true,
  "data": [
    {
      "id": "job_001",
      "name": "otp",
      "failedReason": "Connection timeout",
      "attemptsMade": 3,
      "timestamp": 1715942400000
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 2,
    "totalPages": 1
  }
}

Modified at 2026-07-10 13:15:30

Get Queue Status

Retry Failed Job