Skip to main content
GET
Inbound delivery counts by status

Authorizations

X-API-Key
string
header
required

Response

Successful Response

The whole operator-facing read surface for inbound deliveries.

counts
DeliveryStatusCounts · object
required

Row counts per delivery status. COUNTS ONLY — never a body, ever.

The fields are spelled out rather than carried in a free-form mapping so the schema itself is the guarantee: there is no key into which a raw body, a header value or a sender-supplied URL could be slipped later without the change being visible in the model. tests/test_api_admin_vendor_deliveries asserts this class's field names equal the shared status vocabulary, so a new status fails a test instead of going unreported.

needs_attention
boolean
required

True when any delivery is quarantined or failed — the same condition the committed alert rule fires on.