List webhook deliveries

GET

/v1/deliveries

curl --request GET \
  --url 'https://api.inboxcnx.com/v1/deliveries?status=pending&include=total' \
  --header 'Authorization: Bearer <token>'

Lists the webhook deliveries of the caller application, newest first, so you can see what reached each endpoint and why a delivery failed. Filter by status, endpoint, event id and creation time. Keyset pagination. A grant token sees the deliveries of its own grant.

Requires the read:messages scope.

Authorizations

• apiKey
• grantToken

Parameters

Query Parameters

status

string

Allowed values: pending failed success dlq cancelled

endpointId

string format: uuid

eventId

string

>= 1 characters

after

string format: date-time

before

string format: date-time

cursor

Opaque pagination cursor: a previous response’s nextCursor or prevCursor, passed back verbatim. A cursor issued under one sort order is rejected if reused with another.

string

Opaque pagination cursor: a previous response’s nextCursor or prevCursor, passed back verbatim. A cursor issued under one sort order is rejected if reused with another.

limit

Page size, between 1 and 200. Default 50.

integer

>= 1 <= 200

Page size, between 1 and 200. Default 50.

include

total adds the number of matching results, counted up to 10000.

string

Allowed values: total

total adds the number of matching results, counted up to 10000.

Responses

200

A page of deliveries

Media typeapplication/json

object

data

required

Array<object>

object

id

required

string

endpointId

required

string

eventId

required

string

eventType

required

string

status

required

string

Allowed values: pending failed success dlq cancelled

targetUrl

required

string | null

attemptCount

required

integer

responseStatus

required

integer | null

lastError

required

string | null

createdAt

required

string

updatedAt

required

string

deliveredAt

required

string | null

nextAttemptAt

required

string | null

nextCursor

required

Pass back as cursor for the next page. Null on the last page.

string | null

prevCursor

required

Pass back as cursor for the previous page. Null on the first page.

string | null

total

Present only when requested with include. exact is false once the count reaches 10000 (or the depth cap of a relevance search); count is then that cap.

object

count

required

integer

exact

required

boolean

Example

{
  "data": [
    {
      "id": "6d4e2f1a-9b8c-4d7e-a5f6-0c1b2a3d4e5f",
      "endpointId": "3f9a1c7e-2b4d-4e8f-a6c0-9d1e2f3a4b5c",
      "eventId": "grant.created:9b2f0c4e-6a1d-4f3b-8c55-0d7e2a91b3c4",
      "eventType": "grant.created",
      "status": "failed",
      "targetUrl": "https://hooks.example.com/inboxcnx",
      "attemptCount": 2,
      "responseStatus": 503,
      "lastError": "HTTP 503",
      "createdAt": "2026-10-23T08:00:00.000Z",
      "updatedAt": "2026-10-23T08:00:31.000Z",
      "deliveredAt": null,
      "nextAttemptAt": "2026-10-23T08:02:31.000Z"
    }
  ],
  "nextCursor": null,
  "prevCursor": null
}

400

Invalid query or malformed cursor

Media typeapplication/json

object

error

required

object

code

required

string

message

required

string

Example ^generated

{
  "error": {
    "code": "example",
    "message": "example"
  }
}

403

The credential lacks the read:messages scope

Media typeapplication/json

object

error

required

object

code

required

string

message

required

string

Example ^generated

{
  "error": {
    "code": "example",
    "message": "example"
  }
}