Stablecoins APIbetaReporting

Get report by ID

GET
/reports/{id}

Fetch report details. Poll until status is REPORT_AVAILABLE, then use GET /reports/{id}/download to download the CSV.

Authorization

Bearer
headerAuthorizationBearer <token>

OAuth access token.

Path Parameters

id*string

Identifier of the report.

Formatuuid

Header Parameters

X-Volt-Api-Version*1

Version of the API used. Currently, version 1 is the only version.

Value in1

Response Body

OK - Successful request, returning given report's details.

application/json
  1. response
id*string

Identifier of the report.

Formatuuid
type*"WALLET"

Report type.

Value in"WALLET"
walletId*string

Identifier of the wallet covered by the report.

Formatuuid
startDate*string

Inclusive start of the report period, UTC.

Formatdate-time
endDate*string

Exclusive end of the report period, UTC.

Formatdate-time
status*ReportStatusEnum

Report status.

ValueMeaning
REPORT_REQUESTEDAccepted, generation not started.
REPORT_GENERATINGThe file is being generated.
REPORT_AVAILABLEThe file is available for 7 days after generation.
REPORT_FAILEDGeneration failed. Request the report again.
REPORT_EXPIREDThe file expired. Request the report again.
Value in"REPORT_REQUESTED""REPORT_GENERATING""REPORT_AVAILABLE""REPORT_FAILED""REPORT_EXPIRED"
createdAt*string

Date of report creation.

Formatdate-time
generatedAt*|

Date of report generation. Null until the file is generated.

Formatdate-time
curl -X GET "https://example.com/reports/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "X-Volt-Api-Version: 1"

{  "id": "84a049a4-bcfb-42f2-80ee-0c126d55e7ed",  "type": "WALLET",  "walletId": "6a4f0c9e-2d1b-4c8a-9f3e-b7d2a1c4e5f6",  "startDate": "2026-08-01T00:00:00Z",  "endDate": "2026-09-01T00:00:00Z",  "status": "REPORT_AVAILABLE",  "createdAt": "2026-09-02T10:12:03Z",  "generatedAt": "2026-09-02T10:12:05Z"}

Create wallet report POST

Create a CSV report for the selected wallet and period. The report includes every booked entry, wallet fees, opening and closing balances, and the balance after each entry. Generation is asynchronous. Check availability using `GET /reports/{id}`, then download the CSV using `GET /reports/{id}/download`. Files are kept for 7 days after generation. A period without entries produces a report with opening and closing balances. The period is `[startDate, endDate)` in UTC. The end must be at least one hour in the past and at most 92 days after the start. Use midnight UTC on both ends for calendar days or months. At most 3 reports may be generating per wallet at a time. Every request creates a new report; no idempotency key is required. See the [wallet report guide](/implementation/power-tools/reporter/wallet-report) for the CSV fields.

Download report GET

Download a generated report as a CSV attachment. Return `404` when the report does not exist, belongs to another customer, is still generating, has failed or has expired.