Partner Program

Get your partnership

curl https://api.subscriby.net/v1/me/partner \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN"

Where you stand, whole. status is applied while Subscriby reviews the application, active once approved, rejected with reapply_available_at when it was declined, or suspended. Until approval the computed parts are null: there is no code, no links, no commission_percent, no balance.

Once approved:

  • code is the seven-character partner code and links.web the address to hand out; links.connectors carries one deep link per connector whose bot signs creators up, each opening the sign-up conversation with the code attached.
  • commission_percent is the rate a creator who converts from now on is locked to, as a decimal string with two places. It is a ladder: base_percent plus commitment_points (the verified promotion commitments) plus volume_points (the volume tiers reached at paying_referrals), capped at max_percent; next_tier_at and next_tier_points say what the next tier takes and adds. A referral keeps the rate it was promised at conversion; a raise reaches every referral still inside its commission period, a drop only new conversions.
  • referrals tallies the creators brought in by state, and balance carries the ledger's sums as decimal strings with four places in currency: pending (inside the hold), payable (approved and not yet settled, clawbacks netted), credited, paid and earned (all of them together).
  • commitments lists every promotion commitment with its proof state; a commitment is made and its proof submitted on the dashboard or in the bot, where the rules are explained.
get/v1/me/partner

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/me/partner
  • Auth: HTTP bearer

Response

The partner object; 404 RESOURCE_NOT_FOUND until the caller applies.

Example response

{
  "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,
    "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,
      "expired": 1
    },
    "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",
    "terms_accepted_at": "2026-10-02T09:14:02+00:00",
    "terms_version": "2026-10-10",
    "applied_at": "2026-10-01T09:14:02+00:00",
    "joined_at": "2026-10-02T09:14:02+00:00",
    "created_at": "2026-10-01T09:14:02+00:00",
    "updated_at": "2026-10-21T08:00:00+00:00"
  }
}

Changes

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