GET

Retrieves a list of reports. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. Sending the page parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints.

https://shopify.com/admin/api/2020-01/reports.json

https://shopify.dev/docs/admin-api/rest/reference/analytics/report#index-2020-01

Access Token Required: API Key

Query Params

idsstring

A comma-separated list of report IDs.

limitstring

The amount of results to return. (default: 50, maximum: 250)

since_idstring

Restrict results to after the specified ID.

updated_at_minstring

Show reports last updated after date. (format: 2014-04-25T16:15:47-04:00)

updated_at_maxstring

Show reports last updated before date. (format: 2014-04-25T16:15:47-04:00)

fieldsstring

A comma-separated list of fields to include in the response.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'https://shopify.com/admin/api/2020-01/reports.json' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}