Skip to main content
GET
/
v1
/
admin
/
dlq
/
{failure_id}
Get a dead-letter failure
curl --request GET \
  --url https://api.withsplendor.com/v1/admin/dlq/{failure_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'x-splendor-tenant-id: <x-splendor-tenant-id>'
{
  "committed_batch_count": 0,
  "committed_document_count": 0,
  "dataset_id": "app-logs",
  "error_message": "Failed to parse record at line 10",
  "error_type": "ParseError",
  "failed_at": "2026-01-15T09:30:00Z",
  "failed_document_count": 1,
  "failed_document_offset": 10,
  "failure_id": 1,
  "format": "jsonl",
  "last_retry_at": null,
  "repair_kind": null,
  "repair_started_at": null,
  "retry_count": 0,
  "retryable": true,
  "s3_bucket": "acme-logs",
  "s3_etag": "\"5d41402a\"",
  "s3_key": "2026/01/15/app-bad.jsonl.gz",
  "source": "app-logs",
  "source_id": 12,
  "status": "failed",
  "tenant_id": "acme"
}

Authorizations

Authorization
string
header
required

API token issued from the Splendor console.

Headers

x-splendor-tenant-id
string
required

Selects the tenant (workspace) the request acts within.

Path Parameters

failure_id
integer
required

Query Parameters

tenant_id
string
required
Minimum string length: 1

Response

Successful Response

committed_batch_count
integer | null
required
committed_document_count
integer | null
required
dataset_id
string | null
required
error_message
string
required
error_type
string
required
failed_at
string<date-time>
required
failed_document_count
integer | null
required
failed_document_offset
integer | null
required
failure_id
integer
required
format
string | null
required
last_retry_at
string<date-time> | null
required
repair_kind
string | null
required
repair_started_at
string<date-time> | null
required
retry_count
integer
required
retryable
boolean
required
s3_bucket
string
required
s3_etag
string | null
required
s3_key
string
required
source
string | null
required
source_id
integer | null
required
status
string
required
tenant_id
string
required