List Dead Letter Queue (DLQ) tasks for a subscription (Conceptual API)

GET /subscriptions/{subscription_id}/dlq

Retrieve failed delivery tasks for a specific subscription that are in the DLQ.

Path parameters

subscription_id string(uuid) Required

Subscription ID (UUID)

Responses

200 application/json

List of DLQ tasks for the subscription
Hide response attributes Show response attributes object
- id string(uuid)
  
  Unique ID of the DLQ task.
- original_task_id string(uuid)
  
  ID of the original delivery task that failed.
- subscription_id string(uuid)
- payload string
  
  The JSON payload of the failed webhook.
- failed_at string(date-time)
  
  Timestamp when the task was moved to DLQ.
- reason string
  
  Reason for the delivery failure.
- attempt_count integer
  
  Number of attempts made before moving to DLQ.
- status string
  
  Current status of the DLQ task.
  
  Values are pending, retried, or deleted.
404 application/json

The requested resource was not found.
Hide response attribute Show response attribute object
- error string
500 application/json

An unexpected error occurred on the server.
Hide response attribute Show response attribute object
- error string

GET /subscriptions/{subscription_id}/dlq

curl \
 --request GET 'http://localhost:8080/subscriptions/{subscription_id}/dlq'

Response examples (200)

[
  {
    "id": "dlq-uuid",
    "reason": "Max retries exceeded",
    "status": "pending",
    "payload": "{\"event\":\"order.created\"}",
    "failed_at": "2025-05-12T12:10:00Z",
    "attempt_count": 5,
    "subscription_id": "sub-uuid",
    "original_task_id": "task-uuid"
  }
]

Response examples (404)

{
  "error": "string"
}

Response examples (500)

{
  "error": "string"
}