Sign in
Reports

Queue an export of the item revenues report

Queues a CSV export of the item revenues report to be generated asynchronously.

get/shop/reports/item-revenues/queue

Query parameters

site_idstring uuid required

Restrict to items at the given site.

revenue_date_fromstring date
Example:2026-06-01

Restrict to items belonging to baskets with a revenue date on or after this date.

revenue_date_tostring date
Example:2026-06-30

Restrict to items belonging to baskets with a revenue date on or before this date.

item_date_fromstring date

Restrict to items dated on or after this date.

item_date_tostring date

Restrict to items dated on or before this date.

order_submitted_at_fromstring date-time

Restrict to items belonging to baskets submitted on or after this time.

order_submitted_at_tostring date-time

Restrict to items belonging to baskets submitted on or before this time.

offering_typestring
Example:appointment

Filter to items of a particular offering type. Pass all to include every type (the default when filters omit this).

offering_idsstring[]

A comma-separated list of offering IDs to filter on.

revenue_centresstring[]

A comma-separated list of revenue centre keys or IDs to filter on.

emailboolean

If true, email the completed CSV to the authenticated user when the background job finishes. Defaults to false, in which case the queued job's output URL must be polled via the queued-jobs endpoint.

Response

The job was successfully queued

Example response

{
  "data": {
    "created_at": "2023-11-07T00:00:00+00:00",
    "updated_at": "2023-11-07T01:00:00+00:00"
  }
}

Changes