Failures

A failed delivery is one that bounced, drew a complaint or failed outright, dry runs excluded, counted on the day it was recorded. A failed execution is an automation run that stopped with an error, counted on the day it stopped. Both are read-only views over the delivery log and the executions, windowed to the last days UTC days ending today, so there is nothing here to resolve or dismiss.

GET /v1/failures/stats

Failed deliveries and executions per day, and the newest ones

Auth: Session token.

Query parameters

{
  "days": 30
}

Field	Type	Required	Constraints
days	integer	no	default 30; 1 ≤ x ≤ 90

Response 200

{
  "data": {
    "days": 1,
    "volume": [
      {
        "day": "string",
        "deliveries": 42,
        "executions": 42
      }
    ],
    "recent": [
      {
        "type": "delivery",
        "id": "string",
        "at": "2026-01-15T09:30:00.000Z",
        "appId": "string",
        "automation": "string",
        "step": "string",
        "error": "string"
      }
    ]
  },
  "meta": {
    "requestId": "string",
    "nextCursor": "string",
    "hasMore": true,
    "warnings": [
      {
        "code": "string",
        "message": "string",
        "suggestion": "string"
      }
    ]
  }
}

Field	Type	Required	Constraints
data	object	yes
data.days	integer	yes	1 ≤ x ≤ 90
data.volume	object[]	yes
data.volume[]	object	yes
data.volume[].day	string	yes
data.volume[].deliveries	integer	yes	0 ≤ x ≤ ∞
data.volume[].executions	integer	yes	0 ≤ x ≤ ∞
data.recent	object[]	yes
data.recent[]	object	yes
data.recent[].type	“delivery” | “execution”	yes
data.recent[].id	string	yes
data.recent[].at	string (date-time)	yes
data.recent[].appId	string | null	yes
data.recent[].automation	string | null	yes
data.recent[].step	string | null	yes
data.recent[].error	string | null	yes
meta	object	no
meta.requestId	string	no
meta.nextCursor	string | null	no
meta.hasMore	boolean	no
meta.warnings	object[]	no
meta.warnings[]	object	no
meta.warnings[].code	string	yes
meta.warnings[].message	string	yes
meta.warnings[].suggestion	string	no

Errors follow the shared envelope and code table.