GET
/
reports
/
promoters
curl --request GET \
  --url https://v2.firstpromoter.com/api/v2/company/reports/promoters \
  --header 'Account-ID: <account-id>' \
  --header 'Authorization: Bearer <token>'
[
  {
    "promoter": {
      "id": 123,
      "email": "[email protected]",
      "name": "<string>"
    },
    "id": 123,
    "data": {
      "revenue_amount": 123,
      "net_revenue_amount": 123,
      "promoter_earnings_amount": 123,
      "customers_count": 123,
      "referrals_count": 123,
      "clicks_count": 123,
      "active_customers": 123,
      "3m_epc": 123
    },
    "sub_data": [
      {
        "period": "<string>",
        "id": "<string>",
        "data": {
          "revenue_amount": 123,
          "net_revenue_amount": 123,
          "promoter_earnings_amount": 123,
          "customers_count": 123,
          "referrals_count": 123,
          "clicks_count": 123,
          "active_customers": 123,
          "3m_epc": 123
        }
      }
    ]
  }
]

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

​
columns
enum<string>[]
required

Fields to be included in the report

Available options:
active_customers,
monthly_churn,
clicks_count,
net_revenue_amount,
revenue_amount,
referrals_count,
customers_count,
sales_count,
refunds_count,
cancelled_customers_count,
promoter_earnings_amount,
non_link_customers,
referrals_to_customers_cr,
3m_epc,
6m_epc,
clicks_to_customers_cr,
clicks_to_referrals_cr,
promoter_paid_amount,
signups_count
​
q
string

Search query string

​
group_by
enum<string>
required

Time period grouping

Available options:
day,
week,
month,
year
​
start_date
string
required

Start date for the report period

​
end_date
string
required

End date for the report period

​
sorting
object

Sorting parameters

Response

200
application/json
Successful response

The response is of type object[].