Skip to Content
SendlySendly
API ReferenceCampaigns

Retrieve campaign statistics

GET
/api/v1/campaigns/{id}/stats

Delivery and engagement counters for one campaign, plus the rates derived from them. Every number is a materialized counter on the campaign row, so this is a single indexed read regardless of how many emails the campaign sent — cheap enough to poll while a campaign is in flight.

Rates are percentages (0–100) against sent, and are 0 before anything has been sent.

Requires the campaigns:read scope — View your campaigns and their performance.

headerAuthorizationBearer <API Key>

API key authentication. Use a sk_* (FULL) or pk_* (SENDING_ONLY) key as the bearer token. Public keys (pk_*) are restricted to the email-send endpoints and the self-serve list subscribe/unsubscribe pair; every other endpoint — event tracking included — answers 403 for them. In scope terms (used by /api/v1/* operations): FULL keys hold every scope; SENDING_ONLY keys hold only emails:send.

id*string

Resource id.

Formatuuid

Response Body

Campaign statistics

application/json
  1. response

Materialized delivery and engagement counters for one campaign.

total_recipients*integer
sent*integer
delivered*integer
opened*integer
clicked*integer
bounced*integer
open_rate*number
click_rate*number
bounce_rate*number
delivery_rate*number
Example Request
curl -X GET 'https://api.sendly.now/api/v1/campaigns/497f6eca-6276-4993-bfeb-53cbbbba6f08/stats'
Example Response
{  "total_recipients": 0,  "sent": 0,  "delivered": 0,  "opened": 0,  "clicked": 0,  "bounced": 0,  "open_rate": 0,  "click_rate": 0,  "bounce_rate": 0,  "delivery_rate": 0}