Partner Program

List your referrals

curl "https://api.subscriby.net/v1/me/partner/referrals?status=converted&per_page=25" \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN"

Pages the creators you brought to Subscriby, newest first. status is signed_up, converted, under_review, expired or rejected. Each row names the referred creator by display name alone: they are a Subscriby customer, not yours, so their email and id never appear. An application still under review has no referrals and answers an empty page.

get/v1/me/partner/referrals

Request

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

Query parameters

status'signed_up' | 'converted' | 'under_review' | 'expired' | 'rejected'

What became of a referred creator's sign-up. SignedUp waits for a first paid Starter or Growth invoice inside the conversion window; Converted has one and earns for the commission period; UnderReview converted on a card that matches the partner's and earns nothing until the owner clears or rejects it; Expired ran out of window; Rejected was refused after review.

Keep only referrals in this state: signed_up, converted, under_review, expired or rejected.

pageinteger

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.

per_pageinteger

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

sort_bystring

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

sort_direction'asc' | 'desc'

asc or desc. Defaults to desc.

limitinteger

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

Response

The page.

Example response

{
  "data": [
    {
      "id": "3c4d5e6f-7081-4a2b-9c3d-4e5f6a7b8c9d",
      "referred_name": "Grace Hopper",
      "source": "link",
      "status": "converted",
      "plan": "starter",
      "signed_up_at": "2026-10-08T11:00:00+00:00",
      "expires_at": "2027-04-06T11:00:00+00:00",
      "converted_at": "2026-10-09T14:20:00+00:00",
      "commission_percent": "15.00",
      "commission_ends_at": "2027-10-09T14:20:00+00:00",
      "created_at": "2026-10-08T11:00:00+00:00"
    }
  ]
}

Changes

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