Create wallet report
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 for the CSV fields.
BearerAuthorizationBearer <token>OAuth access token.
walletId*stringIdentifier of the wallet to create a report for.
uuidX-Volt-Api-Version*1Version of the API used. Currently, version 1 is the only version.
1application/json- body
startDate*stringStart of the period (inclusive), ISO 8601 with offset, treated in UTC. Use midnight UTC for day-aligned reports.
date-timeendDate*stringEnd of the period (exclusive), ISO 8601 with offset, treated in UTC. An entry booked exactly at endDate belongs to the next period. At least one hour in the past and at most 92 days after startDate.
date-timeCreated - The report was requested, returning its identifier, status and creation time.
application/json- response
id*stringIdentifier of the report.
uuidstatus*ReportStatusEnumReport status.
| Value | Meaning |
|---|---|
REPORT_REQUESTED | Accepted, generation not started. |
REPORT_GENERATING | The file is being generated. |
REPORT_AVAILABLE | The file is available for 7 days after generation. |
REPORT_FAILED | Generation failed. Request the report again. |
REPORT_EXPIRED | The file expired. Request the report again. |
"REPORT_REQUESTED""REPORT_GENERATING""REPORT_AVAILABLE""REPORT_FAILED""REPORT_EXPIRED"createdAt*stringDate of report creation.
date-timecurl -X POST "https://example.com/reports/wallet/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "X-Volt-Api-Version: 1" \ -H "Content-Type: application/json" \ -d '{ "startDate": "2026-08-01T00:00:00Z", "endDate": "2026-09-01T00:00:00Z" }'{ "id": "84a049a4-bcfb-42f2-80ee-0c126d55e7ed", "status": "REPORT_REQUESTED", "createdAt": "2026-09-02T10:12:03Z"}