---
title: "Get available promoter campaigns"
method: GET
path: "/promoter_campaigns"
tags: ["Promoter Campaigns"]
---

# Get available promoter campaigns

`GET /promoter_campaigns`

With this endpoint you can list all promoter campaigns. 
 <Tip>**HTTP Request** <br/>`GET https://api.firstpromoter.com/api/v2/company/promoter_campaigns`</Tip>

## Headers

- `Account-ID` string, required

## Response `200`

List of promoter campaigns

- PromoterCampaign[]
  - `id` integer — Id of the promoter campaign
  - `campaign_id` integer — Id of the campaign
  - `promoter_id` integer — Id of the promoter
  - `created_at` string, date-time — Date and time when the promoter campaign was created
  - `promoter` Promoter
    - `id` integer — ID of the promoter
    - `status` string — Status of the promoter
    - `cust_id` string
    - `email` string — Email of the promoter
    - `created_at` string, date-time — ISO date of when the promoter was created
    - `temp_password` string, nullable — Temporary password created for the promoter
    - `default_promotion_id` integer
    - `pref` string
    - `default_ref_id` string — Default referral id of the promoter
    - `note` string, nullable — A note/description of promoter
    - `w8_form_url` string, nullable — Url of the w8 form
    - `w9_form_url` string, nullable — Url of the w9 form
    - `parent_promoter_id` integer — Parent promoter id
    - `earnings_balance` object — Earning balance of the promoter
      - `cash` integer
    - `current_balance` object — Current balance of the promoter
      - `cash` integer
    - `paid_balance` object — Paid balance of the promoter
      - `cash` integer
    - `auth_token` string — Authentication token generated when the promoter was created
  - `campaign` Campaign
    - `id` integer — Id of the campaign
    - `name` string — Name of the campaign
    - `color` string, nullable — Color assigned to the campaign

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/firstpromoter/apis/firstpromoter-batch-processes-api.md) · [All operations](https://skmtc.net/firstpromoter/apis/firstpromoter-batch-processes-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/firstpromoter/firstpromoter-batch-processes-api/versions/e15f0d026ccf/schema)