Retrieving Available Reports
Using the API, you can retrieve a list of reports that are generated and available for download. The request format is:
https://<url_prefix>/reporting/v3/reports?startTime={startTime}&endTime={endTime}?timeQueryType={timeQueryType}
Value | Description | Required/Optional |
---|---|---|
< url_prefix > | Name of the server from which to
download the report. Use one of these values:
| Required |
{organizationId} | The organization ID under which the
report is subscribed. This can be the merchant ID, account ID, or reseller
ID. | Optional |
{startTime} | Report start date to search on in ISO
8601 format. Example : 2016-11-22T12:00:00.000Z | Required |
{endTime} | Report end date to search on in ISO
8601 format. Example : 2016-11-22T12:00:00.000Z | Required |
{timeQueryType} | Time you would like to search. Valid
values:
| Required |
{reportMimeType} | Format of the report. Valid values
are:
| Optional |
{reportFrequency} | Frequency of the report subscription.
The options are:
| Optional |
{reportName} | Unique name of the report. | Optional |
{reportDefinitionId} | Report definition ID. | Optional |
{reportStatus} | Status of the report. The options
are:
| Optional |
Responses
This call can return one of the following HTTP status codes:
- 200: Ok.
- 400: Invalid request.
- 404: Report not found or there are no available transactions.
For detailed information on the responses,
including which fields are returned, see the Reporting REST API Reference
.