List your commissions

curl "https://api.subscriby.net/v1/me/partner/rewards?status=approved" \  -H "Authorization: Bearer $SUBSCRIBY_TOKEN"

Pages the commission ledger, newest first: one commission row per paid platform invoice of a referred creator, priced from the invoice's total before tax and after discount (base_amount) at the referral's locked rate (amount), plus the clawback rows that answer a reversal of money already settled, each with a negative amount. status is pending (inside the hold), approved (payable), credited (applied as Subscriby Credit), paid (covered by a cash payout) or reversed; note says why a row was reversed or re-priced. The ledger is read-only on every surface: rows are written by invoices, moved by the hold, settled by a credit or a payout and reversed by a refund or a dispute.

Requires ability

account:read

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

MCP tool

list_partner_rewards

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

status?PartnerRewardStatus

Keep only rows in this state: pending, approved, credited, paid or reversed.

Value in

"pending"
"approved"
"credited"
"paid"
"reversed"

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.

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/partner/rewards"

{  "data": [    {      "id": "8e9f0a1b-2c3d-4e5f-8a9b-0c1d2e3f4a5b",      "referral_id": "3c4d5e6f-7081-4a2b-9c3d-4e5f6a7b8c9d",      "kind": "commission",      "invoice_id": "in_1QExampleInvoice00",      "base_amount": "31.2000",      "amount": "4.6800",      "currency": "USD",      "status": "approved",      "hold_until": "2026-11-08T14:20:00+00:00",      "approved_at": "2026-11-08T15:00:00+00:00",      "credited_at": null,      "paid_at": null,      "reversed_at": null,      "payout_id": null,      "reverses_reward_id": null,      "note": null,      "created_at": "2026-10-09T14:20:00+00:00"    }  ],  "links": {    "first": "https://api.subscriby.net/v1/me/partner/rewards?page=1",    "last": "https://api.subscriby.net/v1/me/partner/rewards?page=1",    "prev": null,    "next": null  },  "meta": {    "current_page": 1,    "from": 1,    "last_page": 1,    "path": "https://api.subscriby.net/v1/me/partner/rewards",    "per_page": 25,    "to": 1,    "total": 1  }}

Type definitions

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

export interface Response {  data: PartnerRewardResource[];  links: Links;  meta: Meta;}export interface PartnerRewardResource {  id: string;  referral_id: string;  kind: string;  invoice_id: string | null;  base_amount: string | null;  amount: string;  currency: string;  status: string;  hold_until: string | null;  approved_at: string | null;  credited_at: string | null;  paid_at: string | null;  reversed_at: string | null;  payout_id: string | null;  reverses_reward_id: string | null;  note: string | null;  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 commissions

AuthorizationCopy Anchor Link

Query ParametersCopy Anchor Link

ResponsesCopy Anchor Link

Authorization

Query Parameters

Responses