Skip to main content
The reporting API provides the option to export data for certain services (e.g. newsletter subscribers or orders). The export can be performed in different formats, depending on the respective service. In addition, the API returns status information about the progress of the export process. The following overview shows which services are currently supported and how the status codes are to be interpreted.

​
Supported methods

List of all supported methods.
Command/InfoEndpointsGETPOSTPUTDELETE
Exportreport/

​
General

​
Supported services and formats

The report/ endpoint provides a uniform interface for exporting data from the shop system. The API allows you to start export processes, query their progress and cancel them if necessary. The export function is currently supported for the following services:
ServiceSupported formats
adminUserjson, csv
categoryjson, csv
customerAccountjson, csv
dataFeedjson, csv
dataFeedTemplatejson, csv
inquiryjson, csv, xml
inventoryjson, csv
orderjson, xml
newsletterSubscriberjson, csv
productjson, csv
productRatingjson, csv
seoViewsjson, csv
transactionjson, csv
voucherjson, csv
voucherPresetjson, csv
voucherTemplatejson, csv

​
Status values of the export process

Export processes run asynchronously in the background. During the export, the current Reportstatus is updated continuously. The status of an export operation can take the following values:
ValueNameMeaning
0ReadyThe export process is ready to be executed.
1StartingThe process has been started but has not yet begun.
2RunningThe export is currently being executed.
3PausedThe export is currently paused.
4CanceledThe export process was canceled manually.
5FinishedThe export was completed successfully.
6ErrorAn error occurred during the export.

​
Methods for data export

​
GET report/{service}/status

This endpoint can be used to query the current status of an export process. This includes, among other things, progress, number of processed entries, start and end times, and the link to the exported file (if the export has been completed). For the export, read permissions for the respective service must be available.

​
Example

https://www.<your-shop>.de/admin/api/v1/report/order/status

​
Response

{
    "duration": 0,
    "end": "",
    "fileName": "orders_947bbbc6b27914ea35c0.json",
    "fileUrl": "https://content.<your-shop>.de/report/orders_947bbbc6b27914ea35c0.json",
    "hasProgress": false,
    "lastError": "",
    "percentage": 100,
    "processed": 4,
    "start": "2025-02-19T09:15:15.000000000Z",
    "status": 2,
    "total": 4
}

​
Error codes

ErrorTypeReason
401 UnauthorizedNot authorized: you are not logged in or you do not have the required permissions to start the service.
400 Bad Requestservice is unknown.
503 Service Unavailable”internalError”Redis did not return a status.

​
POST report/{service}/start

This endpoint starts the export process for the specified service. Optionally, filters and the desired output format (json, csv etc.) can be specified via query parameters. To trigger the export, read permissions for the respective service must be available. If an export process for the service is already running, it is canceled automatically before the new export is started.

​
Example

https://www.<your-shop>.de/admin/api/v1/report/order/start?format=json&filter_gte[createdAt]=2024-11-01T00:00:00.000Z

​
Response

{
    "duration": 0,
    "end": "",
    "fileName": "orders_947bbbc6b27914ea35c0.json",
    "fileUrl": "https://content.<your-shop>.de/report/orders_947bbbc6b27914ea35c0.json",
    "hasProgress": false,
    "lastError": "",
    "percentage": 100,
    "processed": 4,
    "start": "2025-02-19T09:15:15.000000000Z",
    "status": 2,
    "total": 4
}

​
Error codes

ErrorTypeReason
401 UnauthorizedNot authorized: you are not logged in or you do not have the required permissions to read the service’s data.
400 Bad Requestservice is unknown.
The service does not support the format.
503 Service Unavailable”Service currently unavailable”The export process could not be triggered.
503 Service Unavailable”internalError”Redis did not return a status.
The status could not be updated in Redis.
The status has not changed for 10 seconds.

​
POST report/{service}/pause

This endpoint can be used to pause a running export process for the specified service. To pause the process, read permissions for the respective service must be available.

​
Example

https://www.<your-shop>.de/admin/api/v1/report/order/pause

​
Response

{
    "duration": 0,
    "end": "",
    "fileName": "orders_947bbbc6b27914ea35c0.json",
    "fileUrl": "https://content.<your-shop>.de/report/orders_947bbbc6b27914ea35c0.json",
    "hasProgress": false,
    "lastError": "",
    "percentage": 100,
    "processed": 4,
    "start": "2025-02-19T09:15:15.000000000Z",
    "status": 3,
    "total": 4
}

​
Error codes

ErrorTypeReason
401 UnauthorizedNot authorized: you are not logged in or you do not have the required permissions to start the service.
400 Bad Requestservice is unknown.
404 Not foundThe process is not running.
503 Service Unavailable”internalError”Redis did not return a status. Redis cannot be reached. The process could not be stopped.

​
POST report/{service}/resume

This endpoint can be used to resume a paused export process for the specified service. To resume the process, read permissions for the respective service must be available.

​
Example

https://www.<your-shop>.de/admin/api/v1/report/order/resume

​
Response

{
    "duration": 0,
    "end": "",
    "fileName": "orders_947bbbc6b27914ea35c0.json",
    "fileUrl": "https://content.<your-shop>.de/report/orders_947bbbc6b27914ea35c0.json",
    "hasProgress": false,
    "lastError": "",
    "percentage": 100,
    "processed": 4,
    "start": "2025-02-19T09:15:15.000000000Z",
    "status": 2,
    "total": 4
}

​
Error codes

ErrorTypeReason
401 UnauthorizedNot authorized: you are not logged in or you do not have the required permissions to start the service.
400 Bad Requestservice is unknown.
404 Not foundThe process has not been paused.
503 Service Unavailable”internalError”Redis did not return a status. Redis cannot be reached. The process could not be stopped.

​
DELETE report/{service}/cancel

This endpoint can be used to cancel a running export process for the specified service prematurely. To end the process, read permissions for the respective service must be available.

​
Example

https://www.<your-shop>.de/admin/api/v1/report/order/cancel

​
Response

{
    "duration": 0,
    "end": "2025-02-19T09:15:15.000000000Z",
    "fileName": "orders_947bbbc6b27914ea35c0.json",
    "fileUrl": "https://content.<your-shop>.de/report/orders_947bbbc6b27914ea35c0.json",
    "hasProgress": false,
    "lastError": "",
    "percentage": 100,
    "processed": 4,
    "start": "2025-02-19T09:15:15.000000000Z",
    "status": 4,
    "total": 4
}

​
Error codes

ErrorTypeReason
401 UnauthorizedNot authorized: you are not logged in or you do not have the required permissions to start the service.
400 Bad Requestservice is unknown.
404 Not foundThe process is not running.
503 Service Unavailable”internalError”Redis did not return a status. Redis cannot be reached. The process could not be stopped.

​
Support

Bei technischen Fragen und Hilfestellungen ist unser Support-Team für Sie erreichbar: Zum Kundenportal Bitte senden Sie uns eine möglichst detaillierte Beschreibung sowie Screenshots, Requests/Antworten, damit wir Ihre Anfrage zeitnah und zielführend beantworten können.