Audit log
List audit log rows with filters and paging.
Audit log
Prefix: /api/v1/audit-log
See Overview for authentication.
The list call is POST. page and size are query parameters. Filters are the JSON body. With no @PageableDefault on the controller, Spring's pageable defaults apply: page=0 and size=20.
Endpoint summary
| Method | Path |
|---|---|
| POST | /audit-log |
List audit logs
POST /api/v1/audit-log?page=0&size=20
Content-Type: application/json
Authorization: Bearer YOUR_API_TOKEN
{}Narrow the page with any of these body fields. All of them are optional.
{
"recordId": "99999999-9999-9999-9999-999999999999",
"objectName": "OrgUnit",
"auditInterval": "LAST_7_DAYS",
"periodStart": "2026-10-01",
"periodEnd": "2026-10-30",
"userId": "d34f51f4-d1d1-44c8-9df2-986b67838080",
"valuesSearch": "Engineering"
}| Field | Description |
|---|---|
recordId | One record's history |
objectName | Object name, for example OrgUnit |
auditInterval | TODAY, YESTERDAY, LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, LAST_60_DAYS, LAST_90_DAYS, LAST_120_DAYS |
periodStart, periodEnd | Inclusive dates, yyyy-MM-dd |
userId | Actor |
valuesSearch | Case-insensitive substring of the serialized old and new JSON |
Response 200 — Spring Page. createdDate is formatted with the tenant date settings. executionId is present only for tenant admins, and only when a workflow execution caused the change.
{
"content": [
{
"id": "12121212-1212-1212-1212-121212121212",
"operation": "INSERT",
"description": "Created Engineering",
"createdDate": "30 Oct 2026 10:50",
"recordId": "99999999-9999-9999-9999-999999999999",
"objectName": "OrgUnit",
"orgId": "88888888-8888-8888-8888-888888888888",
"userName": "ada",
"data": {
"oldRecord": null,
"newRecord": { "name": "Engineering", "code": "ENG" },
"additionalInfo": null
}
}
],
"totalElements": 1,
"totalPages": 1,
"size": 20,
"number": 0,
"first": true,
"last": true,
"empty": false
}operation is INSERT, UPDATE, DELETE, LOGIN, LOGOUT, APPROVAL_SUBMITTED, APPROVED, or APPROVAL_REJECTED.