Skip to main content
GET
/
v1
/
webhooks
/
dlq
List DLQ Messages
curl --request GET \
  --url https://plugin-br-bank-transfer.sandbox.lerian.net/v1/webhooks/dlq \
  --header 'Authorization: Bearer <token>'
{
  "messages": [
    {
      "messageId": "019c96a0-d1d2-7e3f-4a5b-6c7d8e9f0a1b",
      "routingKey": "webhook.transfer.completed",
      "deathReason": "rejected",
      "failureReason": "HTTP 500 from subscriber",
      "tenantId": "11111111-1111-1111-1111-111111111111",
      "transferId": "019c96a0-ab10-7cde-f1a2-0e1f2a3b4c5d",
      "eventType": "transfer.completed",
      "correlationId": "019c96a0-cc10-7abc-d1e2-3f4a5b6c7d8e",
      "retryCount": 5,
      "manualRetryCount": 1,
      "timestamp": "2026-02-01T15:35:00-03:00"
    }
  ],
  "totalCount": 1,
  "returnedCount": 1,
  "returned": 1,
  "hasNextPage": false,
  "hasMore": false
}

Authorizations

​
Authorization
string
header
required

JWT Bearer token authentication. The tenantId is derived from the bearer token or authenticated request context and is not supplied through X-Organization-Id.

Query Parameters

​
limit
integer
default:50

Maximum number of messages to return.

Required range: 1 <= x <= 200
​
offset
integer
default:0

Number of messages to skip for pagination.

Required range: x >= 0

Response

Indicates the DLQ messages page was returned successfully.

​
messages
object[]
required
​
totalCount
integer
required

Tenant-filtered message count visited during this scan. When hasMore is true this is a best-effort lower bound on the true DLQ depth for this tenant, not the full count.

Required range: x >= 0
Example:

1

​
returnedCount
integer
required

Number of messages in this page after offset and limit are applied.

Required range: x >= 0
Example:

1

​
returned
integer

Number of messages returned in this page.

Required range: x >= 0
Example:

1

​
hasNextPage
boolean

Whether there are more tenant-visible messages beyond this page.

Example:

false

​
hasMore
boolean

True when the inspector stopped scanning early after filling the current page.

Example:

false

​
warning
string

Set when pagination may be non-deterministic (e.g., concurrent access shifts ordering).

Example:

"pagination may be non-deterministic under concurrent access"