Get conversions revenue by day

Statistics

Description

Retrieve daily net revenue for your affiliate business.
Returns a time series of net commissions earned grouped by day (after platform fees), with zero values filled in for days with no data.

Authentication Required: User must be authenticated and have the 'affiliate' role.

Users can only query their own affiliate_id.

Parameters

affiliate_id integer query required

The affiliate ID to get conversions revenue statistics for

start_date string query

Start date for the statistics range (ISO 8601 format). Defaults to 30 days ago.

end_date string query

End date for the statistics range (ISO 8601 format). Defaults to current time.

reward_status string query

Filter conversions by reward status. When omitted, all reward statuses are included.

merchant_id integer query

Filter revenue to one merchant.

product_id integer query

Filter revenue to one product.

Responses

200 Successful response with daily conversions revenue

application/json

statusstring

Example: success

dataarray [object]

Array of daily revenue totals, including days with zero revenue

datestring (date)

Example: 2024-01-01

revenuenumber (float)

Example: 12.5

net_revenuenumber (float)

Example: 12.5

gross_commissionnumber (float)

Example: 13.89

Example:

{
  "status": "success",
  "data": [
    {
      "date": "2024-01-01",
      "revenue": 12.5,
      "net_revenue": 12.5,
      "gross_commission": 13.89
    },
    {
      "date": "2024-01-02",
      "revenue": 0,
      "net_revenue": 0,
      "gross_commission": 0
    },
    {
      "date": "2024-01-03",
      "revenue": 34.75,
      "net_revenue": 34.75,
      "gross_commission": 38.61
    },
    {
      "date": "2024-01-04",
      "revenue": 8.2,
      "net_revenue": 8.2,
      "gross_commission": 9.11
    }
  ]
}

401 Authentication required

application/json

Example:

{
  "status": "error",
  "message": "Not authenticated or insufficient permissions"
}

500 Internal server error

application/json

statusstring

Example: error

messagestring

Example: Failed to fetch conversions revenue statistics

errorstring

Example: Connection error