Skip to main content
GET
/
referrals
Get available referrals
curl --request GET \
  --url https://api.firstpromoter.com/api/v2/affiliate/referrals \
  --header 'Account-ID: <account-id>' \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": 123,
    "uid": "<string>",
    "state": "subscribed",
    "metadata": {},
    "created_at": "2023-11-07T05:31:56Z",
    "customer_since": "2023-11-07T05:31:56Z",
    "email": "[email protected]",
    "promoter_campaign": {
      "id": 123,
      "campaign_id": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "campaign": {
        "id": 123,
        "name": "<string>",
        "color": "<string>"
      }
    }
  }
]

Authorizations

​
Authorization
string
header
required

Access token passed as a Bearer token in the Authorization header

Headers

​
Account-ID
string
required

Account identifier that specifies which account is making the request

Example:

"acc_123456"

Query Parameters

​
q
string

Search params. Searches by email, uid, username, website

​
filters[type]
enum<string>

Type (lead or customer)

Available options:
lead,
customer
​
filters[state]
enum<string>

State

Available options:
subscribed,
signup,
active,
cancelled,
refunded,
denied,
pending,
moved
​
filters[created_at][from]
string<date>

created_at start date

​
filters[created_at][to]
string<date>

created_at end date

​
filters[customer_since][from]
string<date>

customer_since start date

​
filters[customer_since][to]
string<date>

customer_since end date

​
filters[campaign_id]

Campaign ids. Can be Integer or an Array of Integers

​
sorting[state]
enum<string>

Sort by state direction

Available options:
asc,
desc
​
sorting[email]
enum<string>

Sort by email direction

Available options:
asc,
desc

Response

Successful response

​
id
integer
​
uid
string
​
state
enum<string>
Available options:
subscribed,
signup,
active,
cancelled,
refunded,
denied,
pending,
moved
​
metadata
object
​
created_at
string<date-time>
​
customer_since
string<date-time>
​
email
string<email>
​
promoter_campaign
object