A report resource represents a previously requested or generated file (typically CSV) summarizing or detailing various store data, such as a customer export, sales summaries, lifetime value, etc.

Report generation happens asynchronously, and may take a number of minutes to prepare. The status value indicates whether the report is ready to download.


View a report
Get just the header response
Get a response explaining which HTTP methods are supported


Property Description Type Constraints
name The type of report generated, indicating the content of the report. "Complete" includes transaction details, summaries, coupon usage, subscription forecasts, and more. "Customers" is for exporting customers to import elsewhere. "Customers_LTV" includes the lifetime value per customer. Must be one of the following: complete, customers, customers_ltv Required
version In the event a report changes significantly, a new version of the report may be available. Leave this empty to retrieve the latest version, or pass a 1 to request a specific version. In the future, additional versions of each named report may be available. string (50 character max). The only valid value at this time is 1. Required
datetime_start A timestamp in the YYYY-MM-DD HH:MM:SS format, for the start of the reporting period, for your store's configured timezone. Note that any offset will be ignored, and the datetime passed in will be used as your store's configured timezone. datetime Required
datetime_end Same as datetime_start, but for the end of the report's timeframe. Note that you likely want to pass 23:59:59 as the time portion, or you may inadvertently miss data from the last day of the reporting period. datetime Required
id Integer Read only
store_id Your store's ID. Integer Read only
user_id The ID of the user that requested the report. Integer Read only
status Possible values include queued, error, and ready. String Read only
url A short-lived URL to download the report. This URL is generated when this resource is returned via a GET request. URL Read only
date_created The date this resource was created. Date Read only
date_modified The date this resource was last modified. Date Read only

Example Representation

    "_links": {
        "curies": [
                "name": "fx",
                "href": "{rel}",
                "templated": true



Zoomable Resources