Analytics

By connector

Members, access and revenue per connector: one row for every connector the scope's projects run or ever granted access on. The figures behind the dashboards' By Connector panel.

curl "https://api.subscriby.net/v1/analytics/connectors?project_id=$PROJECT_ID&period=30d" \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN"
  • installations counts the live, not uninstalled, installations of the connector in the scope; members the members holding at least one account linked on it; members_linked_in_window those who linked one inside the window.
  • live_grants and pending_grants read the access ledger now (pending covers pending, pending_identity and held); granted_in_window and revoked_in_window count the ledger's moves inside the window.
  • gross_usd is every settled payment in the window whose purchase granted access on the connector, converted to USD; share_percent is its part of total_gross_usd. A purchase that grants access on two connectors counts toward both, so shares can exceed 100 in total; attribution says so in the creator's language.
  • The filter allow-lists (plan_ids, statuses, payment_method_ids) do not apply here: installations and linked accounts are not subscriptions.
get/v1/analytics/connectors

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/analytics/connectors
  • 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

One row per connector: installations, members, grants, revenue and share.

Example response

{
  "data": {
    "range": {
      "from": "2026-08-13",
      "to": "2026-09-12"
    },
    "total_gross_usd": 1682,
    "attribution": "A purchase that grants access on two connectors counts toward both.",
    "connectors": [
      {
        "key": "example",
        "name": "Example connector",
        "installations": 2,
        "members": 241,
        "members_linked_in_window": 18,
        "live_grants": 236,
        "pending_grants": 3,
        "granted_in_window": 21,
        "revoked_in_window": 4,
        "gross_usd": 1682,
        "transactions": 58,
        "share_percent": 100
      }
    ]
  },
  "meta": {
    "period": "30d",
    "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13"
  }
}

Changes

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