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.

Requires ability

dashboard:read

The token must hold this ability, or the call is refused with 403.

MCP tool

get_connector_analytics

Runs the same action from an agent, behind the same ability.

Authorization

bearerToken

AuthorizationBearer <token>

A personal access token minted on the dashboard under Settings, then Tokens, sent as Authorization: Bearer sbt_live_…. The token carries the abilities each endpoint lists under Requires ability and is frozen to one team.

In: header

Query Parameters

project_id?string

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.

Formatuuid

period?string

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.

Default"30d"

from?string

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

Formatdate

to?string

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

Formatdate

Responses

200OKapplication/json

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

data*

The response's payload.

meta*

The request's window and scope, echoed back.

401UnauthorizedAUTHENTICATION_REQUIREDapplication/json

The request carries no bearer token, or one that is revoked, malformed, or minted for another environment (an sbt_test_ token on production).

error*

The one envelope every failure uses.

403ForbiddenTOKEN_MISSING_ABILITYapplication/json

The token is valid but does not carry the ability this endpoint requires; error.context.required_ability names the one to grant. An endpoint that also checks who owns a row or which tier the account is on answers FORBIDDEN, TEAM_TIER_REQUIRED or CONNECTOR_TIER_REQUIRED with the same status, and says so in its own description.

error*

The one envelope every failure uses.

429Too many requestsRATE_LIMITEDapplication/json

The token has spent its 300 requests a minute or 10,000 an hour; Retry-After says when the next one is accepted.

error*

The one envelope every failure uses.

Call it from your code

A sample request in your language, the body each status answers with, and the types to hold them.

curl -X GET "https://example.com/v1/analytics/connectors"

{  "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"  }}

Type definitions

The shapes above as types, ready to paste into your client.

export interface Response {  data: Data;  meta: Meta;}export interface Data {  range: Range;  total_gross_usd: number;  attribution: string;  connectors: Connector[];}export interface Range {  from: string;  to: string;}export interface Connector {  key: string;  name: string;  installations: number;  members: number;  members_linked_in_window: number;  live_grants: number;  pending_grants: number;  granted_in_window: number;  revoked_in_window: number;  gross_usd: number;  transactions: string | number;  share_percent: number;}export interface Meta {  period: string;  project_id: string | null;}

By connector

AuthorizationCopy Anchor Link

Query ParametersCopy Anchor Link

ResponsesCopy Anchor Link

Authorization

Query Parameters

Responses