Ctrl+K

List DLQ jobs

get/trade-falcon/api/v1/admin/jobqueue/dlq

Retrieve dead letter queue jobs with optional filtering and pagination

Query Parameters

  • queueNamestring
    Filter by queue name
  • jobTypestring
    Filter by job type
  • movedAfterstring<date-time>
    Filter by moved-to-DLQ date (after)
  • movedBeforestring<date-time>
    Filter by moved-to-DLQ date (before)
  • limitinteger
    Maximum number of results to return (default 50)
    Minimum: >= 0
  • offsetinteger
    Number of results to skip for pagination
    Minimum: >= 0

200 Response

Array of
id string <uuid>required
DLQ entry ID
originalJobId string <uuid>required
ID of the original job that failed
queueName string required
Name of the queue the job belonged to
Example: settlement
groupKey string required
Group key for concurrency control
Example: BitGo Trust:FUNDED
jobType string required
Type of the job
Example: settlement:stage
payload string <byte>required
Base64-encoded job payload
priority integer required
Job priority (lower is higher priority)
attempts integer required
Number of attempts made before moving to DLQ
maxAttempts integer required
Maximum attempts configured for the job
maxDurationMs
integer or null
Maximum duration in milliseconds per attempt
baseDelayMs
integer or null
Base delay in milliseconds for retry backoff
maxDelayMs
integer or null
Maximum delay in milliseconds for retry backoff
retryStrategy
string or null
Retry backoff strategy
Allowed values: EXPONENTIAL LINEAR FIXED
traceContext
dictionary<string, string> or null
OpenTelemetry trace context propagation headers
string
errors array[object] required
A single error entry recording one failure attempt
attempt integer required
The attempt number when this error occurred
type string required
Error type discriminator
Allowed values: ERROR TIMEOUT
message string required
Error message
at string <date-time>required
Timestamp when the error occurred
name string
Error name
stack string
Error stack trace
createdAt string <date-time>required
Original job creation timestamp
movedAt string <date-time>required
Timestamp when the job was moved to DLQ
updatedAt string <date-time>required
Timestamp when the DLQ entry was last updated
reenqueuedJobId
string or null
<uuid>
ID of the new job if this DLQ entry was reenqueued

400 Response

error string required
Human-readable error message
errorName string required
Immutable error code for API integration
reqId string required
Client request id

403 Response

error string required
Human-readable error message
errorName string required
Immutable error code for API integration
reqId string required
Client request id