Request an audit log report

You request an audit log report with a POST against the report API. You have to set the customerId to your Volt customer ID within your hierarchy for which you want to get the report. Without a customerId, the report covers all merchants in your customer hierarchy.

POST /reports/auditlog

{
    "startDate": "2019-08-24T14:15:22+00:00",
    "endDate": "2019-08-24T14:15:22+00:00",
    "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac"
}

Report timeframe

The required fields startDate and endDate define the timeframe for the report. The report includes all payments which were created during the timeframe, on or after startDate and before or on endDate. The maximum for the timeframe is 92 days. This means, you can also request timeframes where both dates are in the past as long as the dates are not more than 92 days apart.

startDate and endDate need to be defined as a timestamp format:

YYYY-MM-DDTHH:MM:SSZ

YYYY: This represents the year using four digits. For example, 2023.
MM: This represents the month using two digits. For example, 08 for August.
DD: This represents the day of the month using two digits. For example, 14.
T: This is a literal character that separates the date portion from the time portion.
HH: This represents the hour using two digits in a 24-hour clock format. For example, 15 for 3:00 PM.
MM: This represents the minute using two digits. For example, 30.
SS: This represents the second using two digits. For example, 45.
Z: This indicates that the time is in Coordinated Universal Time (UTC), also known as Greenwich Mean Time (GMT), with no offset. The “Z” stands for “Zulu time,” which is a term used in aviation and military contexts to refer to UTC time.

Here an example of a complete timestamp in this format:

2023-08-14T15:30:45Z

representing August 14, 2023, at 3:30:45 PM UTC.

Example response for a specific customer

{
    "id": "2f49c894-3edd-4835-a8d2-6862bfa42d51",
    "status": "REPORT_REQUESTED",
    "createdAt": "2023-08-14T11:23:10+00:00"
}

In the response contains the id for the report, the status and the timestamp when the report was requested.

You need the id for further requests on this report and ultimately to fetch it.

← Previous Reports

Next → Example audit log report