Analytics

Subscriber analytics

New sign-ups, cancellations, churn rate, trial-to-paid conversion and the status distribution of the window. The filter allow-lists do not apply: the figures describe the whole membership of the scope, which is what retention is measured against.

curl "https://api.subscriby.net/v1/analytics/subscribers?project_id=$PROJECT_ID" \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN"
get/v1/analytics/subscribers

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/analytics/subscribers
  • Auth: HTTP bearer

Query parameters

project_idstring uuid

Scope the figures to one project the token may see; omit for every project visible to it. A project outside the token's scope:project: allow-list is 404 TENANT_MISMATCH, an unknown one 404 RESOURCE_NOT_FOUND.

periodstring

The preset window: 7d, 14d, 30d (the default), 60d, 90d, mtd, qtd, ytd, 1y or all. Ignored when both from and to are given; an unknown value falls back to the default rather than failing.

fromstring date

The first day of an explicit window, YYYY-MM-DD. Both from and to are needed to override period.

tostring date

The last day of an explicit window, YYYY-MM-DD. Both from and to are needed to override period.

Response

New, canceled, churn, trials and the status mix.

Example response

{
  "data": {
    "range": {
      "from": "2026-08-13",
      "to": "2026-09-12"
    },
    "new_subscribers": 54,
    "canceled_subscribers": 6,
    "active_at_window_start": 241,
    "churn_rate_percent": 2.49,
    "trial_started": 38,
    "trial_converted": 13,
    "trial_to_paid_percent": 34.21
  },
  "meta": {
    "period": "30d",
    "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13"
  }
}

Changes

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