Statistics view of the site's subscribers

One statistics view over the site's subscribers. name picks the view. When the date range is omitted it defaults to the last 7 days.

list-summary returns the list statistics for the range: list size at the end of the range, new subscriptions (gross — re-subscribes included), subscriber-initiated unsubscriptions by how the opt-out arrived (keyword, ai, optOutLink, dashboard, publicApi, integration) and automated cleaning by reason (deactivatedNumber, knownLitigator, landline, reassigned). Net growth is not a field — compute subscriptions − unsubscriptions − cleaning.

list-history returns the same statistics per UTC calendar day of the range, one entry per day, without bucketing.

countries-summary returns the currently subscribed numbers by country (the phone number's carrier country), sorted descending. It is a snapshot: it takes no date range, and a date range returns 400.

subscription-sources returns the new SMS subscriptions collected in the range, one entry per source — where the subscribers came from: opt-in tools by type (popup, landing-page, embedded-form, keyword), and non-tool sources (import, custom-integration, public-api, shopify_checkout, …). Every subscription counts toward exactly one source; a source without SMS subscriptions in the range is absent. Entries are sorted descending by smsSubscriptions. For the per-tool split use /optin-tools/views/optin-tools-summary.

The data of list-summary, list-history and countries-summary is grouped by channel: channel selects the channels and defaults to sms. The legacy facebook channel is not served.

get

Authorizations

X-Recart-API-KeystringRequired

It can be obtained in Recart account after contacting Support

Path parameters

namestring · enumRequired

The view to return

Possible values:

Query parameters

dateFromstring · dateOptional

First day of the range, inclusive (YYYY-MM-DD, UTC). Defaults to 7 days before dateTo. Must not be older than 18 months — the API does not serve older data, and an older dateFrom returns 400.

Example: 2026-08-18

dateTostring · dateOptional

Last day of the range, inclusive — dateTo=2026-08-24 includes the whole of 2026-08-24 (UTC). Defaults to today.

Example: 2026-08-24

Responses

200

Ok

application/vnd.api+json

4XX

HTTP Error response

application/vnd.api+json

5XX

HTTP Error response

application/vnd.api+json

get/subscribers/views/{name}

GET /app-integrations/2023-12/subscribers/views/{name} HTTP/1.1
Host: api.recart.com
X-Recart-API-Key: YOUR_API_KEY
Accept: */*

{
  "data": {
    "type": "subscribers-views",
    "attributes": {
      "subscription-sources": [
        {
          "source": "import",
          "smsSubscriptions": 1200
        },
        {
          "source": "popup",
          "smsSubscriptions": 419
        },
        {
          "source": "shopify_checkout",
          "smsSubscriptions": 86
        },
        {
          "source": "public-api",
          "smsSubscriptions": 12
        }
      ]
    }
  }
}