---
title: "Get promoter details"
method: GET
path: "/promoters/{id}"
tags: ["Promoters"]
---

# Get promoter details

`GET /promoters/{id}`

With this endpoint you can get the details of a promoter. 
 <Tip>**HTTP Request** <br/>`GET https://api.firstpromoter.com/api/v2/company/promoters/{id}`</Tip>

## Path parameters

- `id` string, required

## Query parameters

- `find_by` 'email' | 'cust_id' | 'auth_token' | 'ref_token' | 'promo_code'

## Headers

- `Account-ID` string, required

## Response `200`

Successful response

- 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

## Other responses

- `401` — Unauthorized

---

[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)