Reports

Operation Reports are CSV exports that include all operations for a given Wallet on a given period. They are mainly intended for administrative and back end use.

Creating an operation report is a 2-step process:

1. Request the Report
2. Retrieve the Report

Request a Report

To request a CSV report, you can use the following request.

CURL

curl -X POST {baseUrl}/core-connect/operations/{walletId}/report \
	--header 'Authorization: Bearer {accessToken}' \
	--header 'Content-Type: application/json' \
	-d '{payload}'

Here is a {payload} example:

JSON

{
	"dateFrom":"2022-06-05T00:00:00+02:00",
	"dateTo":"2023-06-15T00:00:00+02:00"
}

Answers with a 201 HTTP Status code.

Retrieve a Report

To check on a report creation and obtain the download URL, you can use the following request.

Note – Parameters are expected in query string

As opposed to the POST request, the dateFrom and dateTo are expected as query parameters. The dates are to be html encoded (e.g., 2024-01-11T11:25:36+01:00 becomes 2024-01-11T11:25:36%2B01:00).

CURL

curl -X GET {baseUrl}/core-connect/operations/{walletId}/report?dateFrom={dateFrom}&dateTo={dateTo} \
	--header 'Authorization: Bearer {accessToken}' \

When the report is still being generated, it outputs:

JSON

{ 
	"status": "CREATED", 
	"url": null 
}

When the report is ready for download, it outputs:

JSON

{ 
	"status": "COMPLETED", 
	"url": "https://dev-connect-files.s3.eu-west-3.amazonaws.com/operation/report/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx.csv"
}

Information – Report creation can time out

If 15 minutes after the initial Report request you are still getting the CREATED status, then the Report creation process has timed out.