List your transaction fees

curl "https://api.subscriby.net/v1/me/transaction-fees?month=2026-10&channel=metered" \  -H "Authorization: Bearer $SUBSCRIBY_TOKEN"

Pages the ledger, the most recently incurred first. month keeps one calendar month (YYYY-MM, UTC) and wins over from and to, which bound the window by instant; project_id keeps one project's lines; channel is connect_at_source or metered; kind is payment_fee, access_code_fee, trial_usage, outage_emails or processing_recovery. Sort with sort_by (occurred_at by default, or fee_amount, units, kind, channel, created_at) and sort_direction.

Each row names what the fee was for and, for a payment's fee, the project, the member, the purchase and the payment it was priced from with the gross amount, the currency and the rate applied. fee_amount is in fee_currency, your billing currency; units are the cents the meter counted, zero on a fee taken at source. A line of a different kind (a trial's waived fees, a recovery's emails, an invoice's processing recovery) carries its meter_identifier and no payment.

Requires ability

account:read

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

MCP tool

list_transaction_fees

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

month?string

Keep only the lines of one calendar month, as YYYY-MM in UTC, such as 2026-10; wins over from and to.

from?string

Keep only lines incurred at or after this instant, ISO 8601.

Formatdate-time

to?string

Keep only lines incurred before this instant, ISO 8601.

Formatdate-time

project_id?string

Keep only the lines earned on this project.

Formatuuid

channel?PlatformFeeChannel

Keep only lines collected one way: connect_at_source (deducted from the member's payment by Stripe Connect) or metered (billed on your own Subscriby invoice).

Value in

"connect_at_source"
"metered"

kind?PlatformFeeKind

Keep only lines of one kind: payment_fee, access_code_fee, trial_usage, outage_emails or processing_recovery.

Value in

"payment_fee"
"access_code_fee"
"trial_usage"
"outage_emails"
"processing_recovery"

page?integer

The 1-based page to return. A page past the last answers an empty data array with meta.total still filled, so a loop can stop without guessing.

Range1 <= value

Default1

per_page?integer

Rows per page, 1 to 100. A higher value clamps to the cap silently. Defaults to 25.

Range1 <= value <= 100

Default25

sort_by?string

The column to order by. Defaults to created_at; a column the endpoint does not offer falls back to the default rather than failing.

Default"created_at"

sort_direction?string

asc or desc. Defaults to desc.

Default"desc"

Value in

"asc"
"desc"

limit?integer

Legacy alias of per_page, kept for clients that predate it. per_page wins when both are sent.

Range1 <= value <= 100

Responses

200OKapplication/json

The page.

data*array<>

The items on this page.

links*

Links to the first, last, previous and next pages.

meta*

The paging counters for this page.

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.

422Validation failedVALIDATION_FAILEDapplication/json

The payload broke a rule, and error.fields maps each offending key to its messages. A refusal from the domain, such as a plan that cannot go on sale or a member who cannot be removed, uses the same code with error.message saying why and no fields. On this endpoint: VALIDATION_FAILED: when month is not YYYY-MM, a bound is not a date, project_id is not an id, or channel or kind is not one of the words above.

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/me/transaction-fees"

{  "data": [    {      "id": "7d2f9b4e-3c1a-4e5b-9f6d-2a8b7c6d5e4f",      "kind": "payment_fee",      "kind_label": "Payment Fee",      "channel": "metered",      "channel_label": "Billed on Invoice",      "provider": "paypal",      "project_id": "0f1e2d3c-4b5a-4968-8776-655443322110",      "project_name": "Acme Club",      "member_id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",      "member_name": "Jane Fox",      "subscription_id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",      "payment_id": "5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b",      "gross_amount": "39.0000",      "gross_currency": "USD",      "rate_percent": "3.0000",      "fee_amount": "1.1700",      "fee_currency": "USD",      "units": 117,      "meter_identifier": null,      "invoice_id": "in_1QExampleInvoice00",      "invoiced_at": "2026-11-01T06:30:12+00:00",      "occurred_at": "2026-10-14T18:02:41+00:00",      "created_at": "2026-10-14T18:02:41+00:00"    }  ],  "links": {    "first": "https://api.subscriby.net/v1/me/transaction-fees?page=1",    "last": "https://api.subscriby.net/v1/me/transaction-fees?page=1",    "prev": null,    "next": null  },  "meta": {    "current_page": 1,    "from": 1,    "last_page": 1,    "path": "https://api.subscriby.net/v1/me/transaction-fees",    "per_page": 25,    "to": 1,    "total": 1  }}

Type definitions

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

export interface Response {  data: TransactionFeeResource[];  links: Links;  meta: Meta;}export interface TransactionFeeResource {  id: string;  kind: string;  kind_label: "Payment Fee" | "Access Code Fee" | "Trial Usage" | "Recovery Emails" | "Processing Recovery";  channel: string;  channel_label: "Taken at Source" | "Billed on Invoice";  provider: string | null;  project_id: string | null;  project_name: string | null;  member_id: string | null;  member_name: string | null;  subscription_id: string | null;  payment_id: string | null;  gross_amount: string | null;  gross_currency: string | null;  rate_percent: string | null;  fee_amount: string;  fee_currency: string;  units: number;  meter_identifier: string | null;  invoice_id: string | null;  invoiced_at: string | null;  occurred_at: string;  created_at: string | null;}export interface Links {  first: string | null;  last: string | null;  prev: string | null;  next: string | null;}export interface Meta {  current_page: number;  from: number | null;  last_page: number;  links: Link[];  path: string | null;  per_page: number;  to: number | null;  total: number;}export interface Link {  url: string | null;  label: string;  active: boolean;}

List your transaction fees

AuthorizationCopy Anchor Link

Query ParametersCopy Anchor Link

ResponsesCopy Anchor Link

Authorization

Query Parameters

Responses