Actions Endpoint

note: The {yourAgencyName} placeholder should be substituted with the subdomain of the URL you use to access the Affluent dashboard. For instance, if you log in at “dundermifflin.affluent.io” then you should replace {yourAgencyName} with “dundermifflin”

The actions endpoint allows you to pull a list of every unique commissionable action (e.g. sales, leads, bonuses, etc) with all associated data Affluent has on that transaction, including SKU data. Importantly, if you're maintaining your own data store, this API allows you to pull actions based on the last time they were modified so that you do not need to perform historical data pulls in order to update pending transactions.

The JSON body requires:

  1. A dates object that specifies the date range for which you would like to query data. Dates are requested in UTC time and the date range you specify can not be larger than 62 days, so please bear that in mind. There are two accepted date types:
  • Use eventDateStart and eventDateEnd to request actions which occurred in that range. This should use dates. For example:
"dates": { "eventDateStart": "2023-09-19", "eventDateEnd": "2023-09-22" }
  • RECOMMENDED FOR DATA STORES: Use affluentModifiedAtStart and affluentModifiedAtEnd to request actions based on a last modified date. This should use datetimes. For example:
"dates": { "affluentModifiedAtStart": "2023-09-21T00:00:00+01:00", "affluentModifiedAtEnd": "2023-09-22T00:00:00+01:00" }
  1. A limit and offset (see Limit and Offset)
  2. An includeCustomFields flag

The JSON body can additionally accept:

  1. Filters. Full description can be found here. For example:
"filters": { "operator": "AND", "statements": [ { "category": "brandName", "match": "equals", "values": "Evil Corp" }, { "category": "publisherName", "match": "notEquals", "values": "Evil Product Reviews" } ] }
  1. An SKU flag (optional) to include or exclude SKU data. The default is false. For example:
"includeSkus": true
Log in to see full request history

Best Practices:

  • Use a limit of 100,000.
Body Params
string
dates
object
integer
1 to 7
Defaults to 1

Specify first day of week: 1 (Monday) - 7 (Sunday)

integer
1 to 100000
Defaults to 100
integer
≥ 0
Defaults to 0

Can be used for pagination in combination with 'limit'

filters
object
having
object
boolean
Defaults to false

If set to true the new experimental pagination logic will be used. That should speed up pagination when dealing with huge results.

boolean
Defaults to false
boolean
Defaults to false
Responses

Language
Credentials
Click Try It! to start a request and see the response here! Or choose an example:
application/stream+json