Skip to main content

Conversions for a period

GET /publisher/conversions/ lists your conversions. Two parameters limit it to a period:

ParameterValue
created_at_0The first day, such as 2026-10-01
created_at_1The last day, such as 2026-10-31. The whole day counts.

Both are ISO 8601 dates, read in the timezone your account is set to. You can check it with GET /my/timezone_preferences/.

A whole month​

All conversions created in October 2026:

curl -X GET "https://api.convertiser.com/publisher/conversions/?created_at_0=2026-10-01&created_at_1=2026-10-31&page_size=100"
-H "Authorization: Token your-personal-secret-token-here"

For the current month so far, leave out created_at_1:

curl -X GET "https://api.convertiser.com/publisher/conversions/?created_at_0=2026-10-01&page_size=100"
-H "Authorization: Token your-personal-secret-token-here"

For a single day, give both parameters the same date: created_at_0=2026-10-12&created_at_1=2026-10-12.

Every page​

The list is paginated. Each response holds at most page_size conversions, up to 100, and count is the total for the period. Request the URL in next until it is null. Pagination describes the fields.

Narrowing it down​

Other filters combine with the period:

  • status=approved returns only approved conversions. The statuses are pending, approved and rejected.
  • processed_at_0 and processed_at_1 filter by the date a conversion was approved or rejected, instead of the date it was created.
  • sale_amount_0 and sale_amount_1 limit the sale amount, both ends inclusive.

The conversions list in the Publisher API names every filter.