v1

latestOpenAPI 3.0.02026-07-264731126.7 KB

Promoters

Get promoter details

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>

get/promoters/{id}

Path parameters

idstring required

The promoter's numeric ID, or the value of the attribute specified in find_by (e.g. an email address, auth token, ref token, promo code, or cust_id)

Query parameters

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

Find by attribute

Headers

Account-IDstring required

Account id. You can find your Account ID on Your FirstPromoter Dashboard. Navigate to Settings → Integrations

Response

Successful response

idinteger

ID of the promoter

statusstring

Status of the promoter

cust_idstring

emailstring

Email of the promoter

created_atstring date-time

ISO date of when the promoter was created

temp_passwordstring nullable

Temporary password created for the promoter

default_promotion_idinteger

prefstring

default_ref_idstring

Default referral id of the promoter

notestring nullable

A note/description of promoter

w8_form_urlstring nullable

Url of the w8 form

w9_form_urlstring nullable

Url of the w9 form

parent_promoter_idinteger

Parent promoter id

auth_tokenstring

Authentication token generated when the promoter was created

Example response

{
  "id": 3920164,
  "status": "active",
  "email": "peluwydo@mailinator.com",
  "created_at": "2022-04-26T15:28:24.800Z",
  "temp_password": "xxxxxxxxxx",
  "default_promotion_id": 4210919,
  "pref": "db1znwe",
  "default_ref_id": "8yi2epelut",
  "note": "This is a note",
  "parent_promoter_id": 577918,
  "earnings_balance": {
    "cash": 50744
  },
  "current_balance": {
    "cash": 20044
  },
  "paid_balance": {
    "cash": 30700
  },
  "auth_token": "xxxxxxxxxxxxxx"
}