View and filter audit entries
The audit trail can grow large, so MobilityManager lets you filter and page through entries to find the changes you care about. This article explains the available filters, how paging works, and how to open a single entry.
Required permission
Viewing audit entries requires the settings:view permission. All audit access is read-only and scoped to your current tenant.
Listing entries
Request the audit list from GET /api/audit. Results are returned newest first (by timestamp), together with the total number of matching entries so you can build paging controls.
Available filters
Combine any of these query parameters to narrow the results:
| Filter | Purpose |
|---|---|
entityType | Only changes to a given record type, for example Vehicle or Booking. |
entityId | Only changes to a specific record, identified by its primary key. |
action | Only a given action: Insert, Update, or Delete. |
userEmail | Only changes made by a specific user's email. |
userId | Only changes made by a specific user ID. |
fromDate / toDate | Restrict to a date-and-time range (inclusive). |
Paging through results
Two parameters control the page:
skip— how many entries to skip; defaults to0.take— how many entries to return; defaults to50and is capped at100.
To move through pages, increase skip by your page size on each request. Compare the running total you have retrieved against the reported total count to know when you have reached the end.
Note: Requesting a
takelarger than 100 does not return more than 100 entries — the page size is limited for performance.
Opening a single entry
When you have an entry's numeric ID, retrieve just that entry with GET /api/audit/{auditEntryId}. The response includes the full detail: old and new values, and the changed columns for updates. If the ID does not exist, the request returns "Audit entry not found".
Tip: To investigate one record's full timeline, filter by both
entityTypeandentityId, or use the dedicated entity history view.
Related
- The audit trail and what it captures
- View the audit history of an entity
- View a user's audit history
- Why audit entries cannot be edited or deleted
