Deliverability

Delivery outcomes per recipient domain

Sent, delivered, bounced, complained and opened counts split by the RECIPIENT's domain and by UTC day, newest day first.

This is the axis diagnose cannot report: its recent_delivery is project-wide, because an email row records no sending domain. A project-wide bounce rate hides the case that matters most — one recipient domain refusing almost everything while the rest is healthy.

The counts are maintained by an hourly job over a rolling 30-day window, NOT computed on request; computed_at on each row says when it was last rebuilt. No rate is published: a rate over three sends is not information, and the counts let you apply your own threshold.

Requires the deliverability:read scope — Check why mail from one of your domains is not arriving.

get/api/v1/deliverability/domains

Request

  • Base URL: https://api.sendly.now
  • URL: https://api.sendly.now/api/v1/deliverability/domains
  • Auth: one of:
    • HTTP bearer
    • API key in cookie better-auth.session_token
    • OAuth 2 (authorization code, authorization URL https://app.sendly.now/api/auth/oauth2/authorize, token URL https://app.sendly.now/api/auth/oauth2/token, scopes: deliverability:read)

Query parameters

limitinteger
afterstring

Opaque cursor from a previous response's next_cursor.

daysinteger

How far back to read. 1-30 days; defaults to 30, which is the window the job maintains.

domainstring

Restrict to one recipient domain.

Response

Cursor-paginated recipient-domain rollup

has_moreboolean required
next_cursorstring nullable required

Pass as after to fetch the next page. null on the last page.

Changes

No recorded changes to this operation across all 1 revision of this API.