---
title: "Your customer discount links and what they earned [read]"
method: GET
path: "/billing/referral-links"
---

# Your customer discount links and what they earned \[read\]

`GET /billing/referral-links`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/billing/referral-links`
- Auth: none declared

For an account on an eligible platform discount plan: the plan links are priced from (source_plan.multiplier is the lowest share of public price a customer can be given), the active SKUs with your own price for each, every link you created with its customer price, redemptions and status, and your earnings per referred customer. 403 not_eligible for any other account.

## Response `200`

OK

- object
  - `source_plan` object, required
    - `id` string
    - `name` string
    - `multiplier` number
  - `skus` object[], required
    - `id` string
    - `name` string
    - `kind` string
    - `source_multiplier_bps` integer
    - `second_list_usd` number, nullable
    - `source_second_usd_per_unit` number, nullable
  - `links` ReferralLink[], required
    - `id` string
    - `url` string, uri
    - `created_at` string, date-time
    - `customer_multiplier` number: Share of public price the customer pays
    - `custom_price_count` integer: SKUs priced differently from your own price
    - `prices` object[]
      - `sku_id` string
      - `customer_multiplier_bps` integer
      - `customer_second_usd_per_unit` string, nullable
    - `audience_email` string, nullable
    - `email_status` string
    - `max_redemptions` integer
    - `redeemed_count` integer
    - `expires_at` string, date-time
    - `disabled_at` string, date-time, nullable
  - `earnings` object[], required
    - `enrollment_id` string
    - `amount_usd` number
    - `last_earned_at` string, date-time, nullable
    - `referred_user` object
      - `name` string, nullable
      - `email` string, nullable

## Other responses

- `default`: Error — { error: { code, message, request_id } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/billing/referral-links/get.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/0d435187cd55?raw)