Skip to content

Get delivery statistics

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

Counts webhook deliveries by status over time, per endpoint and per event type, with delivery latency, to chart how well your receivers keep up. Counts the deliveries created in [after, before), by default the last seven days and at most 92 days, optionally of one status or endpoint. The series is hourly up to two days and daily beyond.

Requires the read:messages scope.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
after
string format: date-time
before
string format: date-time
status
string
Allowed values: pending failed success dlq cancelled
endpointId
string format: uuid

Responses

Section titled “Responses”

200

Section titled “200”

Delivery counts for the range

Media typeapplication/json
object
after
required
string
before
required
string
bucket
required
string
Allowed values: hour day
totals
required
object
total
required
integer
pending
required
integer
failed
required
integer
success
required
integer
dlq
required
integer
cancelled
required
integer
latency
required
object
p50Ms
required
number
p95Ms
required
number
series
required
Array<object>
object
total
required
integer
pending
required
integer
failed
required
integer
success
required
integer
dlq
required
integer
cancelled
required
integer
start
required
string
byEndpoint
required
Array<object>
object
total
required
integer
pending
required
integer
failed
required
integer
success
required
integer
dlq
required
integer
cancelled
required
integer
endpointId
required
string
url
required
string
deleted
required
boolean
latency
required
object
p50Ms
required
number
p95Ms
required
number
byEventType
required
Array<object>
object
total
required
integer
pending
required
integer
failed
required
integer
success
required
integer
dlq
required
integer
cancelled
required
integer
eventType
required
string
endpoints
required
Array<object>
object
endpointId
required
string
url
required
string
deleted
required
boolean

Example 

{
  "after": "2026-10-22T08:00:00.000Z",
  "before": "2026-10-23T08:00:00.000Z",
  "bucket": "hour",
  "totals": {
    "total": 120,
    "pending": 1,
    "failed": 2,
    "success": 116,
    "dlq": 1,
    "cancelled": 0
  },
  "latency": {
    "p50Ms": 180,
    "p95Ms": 950
  },
  "series": [
    {
      "start": "2026-10-22T08:00:00.000Z",
      "total": 5,
      "pending": 0,
      "failed": 0,
      "success": 5,
      "dlq": 0,
      "cancelled": 0
    }
  ],
  "byEndpoint": [
    {
      "endpointId": "3f9a1c7e-2b4d-4e8f-a6c0-9d1e2f3a4b5c",
      "url": "https://hooks.example.com/inboxcnx",
      "deleted": false,
      "latency": {
        "p50Ms": 180,
        "p95Ms": 950
      },
      "total": 120,
      "pending": 1,
      "failed": 2,
      "success": 116,
      "dlq": 1,
      "cancelled": 0
    }
  ],
  "byEventType": [
    {
      "eventType": "message.received",
      "total": 120,
      "pending": 1,
      "failed": 2,
      "success": 116,
      "dlq": 1,
      "cancelled": 0
    }
  ],
  "endpoints": [
    {
      "endpointId": "3f9a1c7e-2b4d-4e8f-a6c0-9d1e2f3a4b5c",
      "url": "https://hooks.example.com/inboxcnx",
      "deleted": false
    }
  ]
}

400

Section titled “400”

A reversed range, or one longer than the maximum

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string

Example generated

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

403

Section titled “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"
  }
}