get_partner_program
Fetch where the token's creator stands in the Partner Program — the application's state, the code and links, the commission ladder, the referral tallies, the balances and how they are paid. Read-only, never the payout destination.
Read the creator's own standing in the Partner Program, Subscriby's
programme that pays a creator a share of every platform invoice the creators they bring to Subscriby
pay. The token says whose partnership it is, so the tool takes no input; it renders the same object
as GET /v1/me/partner, so an agent and an app reading the same token see the same figures.
One object for every state: an application under review (status: "applied") carries its
commitments and nothing computed; an approved partner carries the code, the links, the ladder
(commission_percent with its base_percent, commitment_points, volume_points and the next
volume tier), the referrals tallies by state, the balance sums, the payout_method with
payout_details_complete, the tax declaration, the terms acceptance and every commitment with its
proof state.
Read-only. Never mutates anything.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same action as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Annotations
It reads and never changes anything.
Arguments
This tool takes no arguments.
What it returns
{ "data": { "id": "4b7e2d19-5c3a-4f80-9e6b-1d2c3b4a5f60", "status": "active", "code": "ADA7Q2X", "links": { "web": "https://app.subscriby.net/r/ADA7Q2X", "connectors": [ { "connector": "telegram", "name": "Telegram", "url": "https://t.me/SubscribyBot?start=partner_ADA7Q2X" } ] }, "commission_percent": "15.00", "base_percent": 5, "max_percent": 30, "commitment_points": 10, "volume_points": 0, "paying_referrals": 3, "next_tier_at": 10, "next_tier_points": 5, "commission_months": 12, "hold_days": 30, "minimum_cash_payout": "50", "friend_discount_percent": 20, "friend_discount_months": 3, "currency": "USD", "clicks": 412, "referrals": { "total": 7, "signed_up": 3, "converted": 3, "under_review": 0, "expired": 1, "rejected": 0 }, "balance": { "pending": "11.7000", "payable": "52.6500", "credited": "0.0000", "paid": "117.0000", "earned": "181.3500" }, "payout_method": "paypal", "payout_details_complete": true, "legal_name": "Ada Lovelace", "tax_country": "GB", "us_person": false, "terms_accepted_at": "2026-10-02T09:14:02+00:00", "terms_version": "2026-10-10", "commitments": [ { "id": "9c1d2e3f-4a5b-4c6d-8e7f-0a1b2c3d4e5f", "kind": "long_form_video", "status": "verified", "audience_channel": "youtube", "audience_url": "https://www.youtube.com/@ada", "reach": "up_to_50k", "points": 10, "proof_url": "https://www.youtube.com/watch?v=example", "promised_at": "2026-10-01T09:14:02+00:00", "due_at": "2026-12-01T09:14:02+00:00", "proof_submitted_at": "2026-10-20T16:41:11+00:00", "verified_at": "2026-10-21T08:00:00+00:00", "lapsed_at": null, "created_at": "2026-10-01T09:14:02+00:00" } ], "applied_at": "2026-10-01T09:14:02+00:00", "joined_at": "2026-10-02T09:14:02+00:00", "rejected_at": null, "rejection_reason": null, "reapply_available_at": null, "suspended_at": null, "created_at": "2026-10-01T09:14:02+00:00", "updated_at": "2026-10-21T08:00:00+00:00" }}The payout destination never travels
payout_method names the rail and payout_details_complete says whether
it has everything a payment needs. The PayPal address, the wallet or the
bank account are written by
update_partner_payout_details
and returned by nothing, on any surface.
commission_percent is the rate a creator who converts from now on is locked to, a decimal
string with two places; a referral keeps the rate it was promised at conversion. balance holds
decimal strings with four places in currency: pending is inside the hold, payable is approved
and not yet settled with clawbacks netted, earned is everything together. minimum_cash_payout
is the balance a cash rail reaches before Subscriby pays.
How it fails
RESOURCE_NOT_FOUNDthe creator never applied to the programme. Applying is done on the
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks account:read.
How is this guide?
Last updated on
accept_partner_terms
Record that the token's creator accepts the Partner Program Terms as they stand, which every payout rail requires. Idempotent.
list_partner_payouts
List the cash payouts Subscriby made to the token's creator as a partner — the amount, the rail, the transfer's reference and how many commissions each covered. Read-only.