Skip to main content
GET
/
campaigns
cURL
curl --request GET \
  --url https://firstpromoter.com/api/v1/reports/campaigns \
  --header 'X-API-KEY: <api-key>'
[
  {
    "campaign_name": "Test Campaign",
    "campaign_id": 18519,
    "items": [
      {
        "revenue_amount": "$613.17",
        "clicks_count": 100,
        "referrals_count": 60,
        "customers_count": 30,
        "period": "Sep 2024"
      }
    ],
    "revenue_amount": "$613.17",
    "clicks_count": 100,
    "referrals_count": 60,
    "customers_count": 30
  }
]

Authorizations

​
X-API-KEY
string
header
required

Query Parameters

​
selected_fields[]
enum<string>[]

An array of fields to return on the response. By default selected fields are revenue_amount, clicks_count, referrals_count, customers_count.

​
group_by
enum<string>

Period to group by. By default is month. For day grouping, reporting period span is limitd at 90 days

Available options:
day,
month,
year
​
start_date
string

Beginning of reporting period. Default is set as 12 months ago

​
end_date
string

End of reporting period. Default is set as today

Response

Campaign report response

​
campaign_name
string

Name of the campaign

Example:

"Test Campaign"

​
campaign_id
number

ID of the Campaign

Example:

18519

​
items
object[]
​
revenue_amount
string
Example:

"$613.17"

​
clicks_count
number
Example:

100

​
referrals_count
number
Example:

60

​
customers_count
number
Example:

30