---
title: "List campaigns"
method: GET
path: "/affiliate-campaigns"
tags: ["Affiliates"]
---

# List campaigns

`GET /affiliate-campaigns`

## Request

- Base URL: `https://api.supersendtx.com`
- URL: `https://api.supersendtx.com/affiliate-campaigns`
- Auth: HTTP bearer

Every campaign is one commission plan. Not paged.

## Query parameters

- `include_archived` boolean

## Response `200`

Campaigns, default first

- AffiliateCampaignListResponse
  - `data` AffiliateCampaign[], required
    - `object` 'affiliate_campaign', required
    - `id` string, required
    - `name` string, required
    - `description` string, nullable
    - `is_default` boolean, required
    - `visibility` 'public' | 'private'
    - `auto_approve` boolean
    - `commission_type` 'percent' | 'flat', required
    - `commission_bps` integer: Percent in basis points (2000 = 20%)
    - `commission_flat_cents` integer
    - `commission_duration` 'once' | 'recurring', required
    - `recurring_months` integer, nullable: `null` = for the customer lifetime
    - `max_commission_cents` integer, nullable
    - `tiers` AffiliateCommissionTier[]
      - `min_paid_customers` integer, required
      - `commission_bps` integer, nullable
      - `commission_flat_cents` integer, nullable
    - `product_rates` AffiliateProductRate[]
      - `stripe_product_id` string, required
      - `commission_bps` integer, required
    - `second_tier_bps` integer: Share of a recruited partner’s commission paid to their recruiter
    - `lead_bounty_cents` integer: Paid once per referred signup, when that customer first pays
    - `cookie_days` integer, required
    - `hold_days` integer, required: Days a commission stays pending before it is earned (refund window)
    - `archived_at` string, date-time, nullable
    - `affiliate_count` integer: List responses only
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Validation error (`details.fields` names each bad field)
- `401`: Missing or invalid API key
- `403`: The API key is not full access, or the action is not allowed

---

[API](https://skmtc.dev/ranla/apis/supersend-tx-api.md) · [All operations](https://skmtc.dev/ranla/apis/supersend-tx-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ranla/apis/supersend-tx-api/revisions/e3e782652f50?raw)