Retrieve Subscription Statistics (Daily)

get

https://{APP_DOMAIN}/api/3.2/subscriptions/statistics/daily

Returns daily time-series data for one statistic metric across subscriptions matching the current subscription filters. The metric determines which dimension is queried: message metrics cover sends/opens/clicks/unsubscribes, subscription metrics cover signup lifecycle events, and campaign metrics cover campaign traffic/conversions/revenue. Campaign filters are effort-level filters used by campaign metrics and conversion-rate calculations; pass campaign_filters such as {"campaign_id":123} to scope campaign stats to a campaign.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

metric

string

enum

Metric to chart. Message metrics: sends, opens, clicks, complaints, list_unsubscribes, unsubscribes, open_rate, click_rate. Subscription metrics: subscribers, new, duplicate, reactivate, renew, list_unsubscribes, unsubscriptions, prunes, hard_bounces, invalids, complaints; these count unique subscriptions per day. Campaign metrics: campaign_clicks, conversions, conversion_rate, revenue, epc, rpm. Defaults to a subscription metric.

dimension

string

enum

Statistics dimension used to interpret the metric. Defaults to subscription.

Allowed:

date_range

string

Date range to include. Accepted values: today, yesterday, all, custom, or any number of days as Nd (for example 7d, 30d, 90d, 180d, 365d). When custom, provide date_from and/or date_to. Defaults to today.

date_from

date

Start date (inclusive) for a custom date_range, in the stats timezone. Only used when date_range is custom.

date_to

date

End date (inclusive) for a custom date_range, in the stats timezone. Only used when date_range is custom.

advanced_query

string

JSON advanced query for subscriber search. Uses the same dynamic segment/subscriber search structure as the subscriptions table.

campaign_filters

string

JSON object of effort-level filters for campaign-scoped stats. Common keys include campaign_id, id, name, partner_id, publication_id, ad_id, message_id, auto_responder_id, effort_type_id, and type. Array values are treated as where-in filters. Applied to campaign metrics and conversion-rate calculations.

publication_id

array of integers

Filter subscriptions by publication ID. Accepts a single value or an array.

publication_id

active

string

enum

Filter subscriptions by status: true for active, false for inactive, or lead for subscriptions without active status.

Allowed:

Response

Language

Credentials

Bearer

JWT

URL

Loading…

Response

Choose an example:

application/json

200Daily statistics time-series data