List event deliveries

Returns a page of event delivery records with attempt history. Filters by status, event type, webhook id, operation id, and date range. Cursor-based pagination — pass the nextCursor from a previous response to continue.

GET /v1/str/event-deliveries

List event deliveries

cURL

curl --request GET \
  --url https://spb.sandbox.lerian.net/v1/str/event-deliveries \
  --header 'Authorization: Bearer <token>'

200

{
  "correlationId": "550e8400-e29b-41d4-a716-446655440005",
  "items": [
    {
      "attempts": 1,
      "createdAt": "2026-06-14T12:00:00Z",
      "deliveryId": "550e8400-e29b-41d4-a716-446655440010",
      "eventId": "550e8400-e29b-41d4-a716-446655440011",
      "eventType": "str.operation.accepted",
      "status": "DELIVERED",
      "updatedAt": "2026-06-14T12:00:00Z",
      "webhookId": "550e8400-e29b-41d4-a716-446655440012",
      "lastAttemptAt": "2026-06-14T12:00:00Z",
      "lastError": "<string>",
      "nextRetryAt": "2026-06-14T12:00:00Z",
      "operationId": "550e8400-e29b-41d4-a716-446655440013"
    }
  ],
  "limit": 24,
  "total": 87,
  "nextCursor": "<string>"
}

Autorizaciones

Authorization · string · header · requerido

JWT bearer token issued by the identity provider.

Parámetros de consulta

status · string

Delivery status filter (PENDING, DELIVERED, FAILED, RETRYING, EXHAUSTED).

Ejemplo:

"DELIVERED"

eventType · string

Canonical event type filter.

Ejemplo:

"str.operation.accepted"

webhookId · string

Webhook endpoint UUID filter.

Ejemplo:

"550e8400-e29b-41d4-a716-446655440012"

operationId · string

Operation aggregate UUID filter.

Ejemplo:

"550e8400-e29b-41d4-a716-446655440013"

startDate · string

Inclusive start date (RFC3339 timestamp or YYYY-MM-DD).

Ejemplo:

"2026-06-14"

endDate · string

Inclusive end date (RFC3339 timestamp or YYYY-MM-DD).

Ejemplo:

"2026-06-14"

cursor · string

Opaque pagination cursor from a previous response.

limit · integer<int64> · predeterminado: 50

Page size (1-100, default 50).

Rango requerido: 1 <= x <= 100

Ejemplo:

24

Respuesta

200

application/json

OK

correlationId · string · requerido

Request-scoped correlation identifier echoing X-Request-ID, for pivoting from response to trace.

Ejemplo:

"550e8400-e29b-41d4-a716-446655440005"

items · object[] | null · requerido

Event delivery records for the current page.

Show child attributes

limit · integer<int64> · requerido

Effective page size applied to this response.

Ejemplo:

24

total · integer<int64> · requerido

COUNT(*) of event deliveries matching the same filters as items, excluding the cursor/limit — the full filtered-set size, stable across pages (a record count, never a monetary sum).

Ejemplo:

87

nextCursor · string

Opaque cursor for the next page; absent when this is the last page. Do not parse.