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.

Request a Report ​

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

bash
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 icon

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).

bash
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"
}
Info icon

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.