List audit events
LogsGET /events
List append-only cryptographic audit events, optionally for one record
Returns the tenant's hash-chained audit events, each with a localized human-readable summary, a summary code and parameters. Filters combine (actor, exact action, resource type and ID, RFC 3339 from/to; unparseable dates are ignored) and results are cursor-paginated (default 20, maximum 100). Requires the audit:read permission.
Parameters
limitMaximum resources to return (default 20, maximum 100).
afterOpaque cursor returned by the previous page.
resource_typeFilter by resource type, e.g. customer, account, property, meter, connection, invoice, payment, ticket, work_order, incident, tariff, onboarding
resource_idFilter by resource identifier, for a record page's history
actionFilter by exact action code
actor_idFilter by actor
fromRFC3339 start
toRFC3339 end
Returns
200 Audit events, newest first
Show attributes
dataShow child attributes
idtenant_idactor_idactor_typeactor_nameDisplay label of the actor; the person's name when known, Sistema for a system actor. Not part of the hash chain.
actionStable action code in English
resource_typeresource_idip_addressuser_agentdetailstimestampprev_hashhashsummaryHuman-readable description in the reader's locale (pt-MZ by default), derived from the action and resource when read; the fallback for summary_code; not part of the hash chain
summary_codeStable code clients translate as audit.<code>: the action when known, change.<resource_type>, or change
summary_paramsValues for the translated summary, such as reference
has_morenext_cursor
Errors 403
Permissions audit:read · Roles: admin, analyst, owner
curl -X GET "$BUSINESS_API/events" \
-H "Authorization: Bearer sk_test_..."
# No matching CLI command; use cURL or direct HTTP.
const res = await fetch("$BUSINESS_API/events", {
method: "GET",
headers: {
Authorization: "Bearer sk_test_..."
}
});
const data = await res.json();
import requests
res = requests.get(
"$BUSINESS_API/events",
headers={
"Authorization": "Bearer sk_test_..."
}
)
data = res.json()
req, _ := http.NewRequest("GET", "$BUSINESS_API/events", nil)
req.Header.Set("Authorization", "Bearer sk_test_...")
resp, err := http.DefaultClient.Do(req)
{
"data": [
{
"id": "aud_26gp5oQrtu49RIq9B685jyQRTCo",
"tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
"actor_id": "act_2HXCuXB4S938w5lomxpoS73e8fr",
"actor_type": "actor type",
"actor_name": "Ana Matsinhe",
"action": "action",
"resource_type": "resource type",
"resource_id": "res_2iAXhMsJzmqPnY6X5cMTJ6OBTSG",
"ip_address": "Av. Julius Nyerere 1420, Maputo",
"user_agent": "user agent",
"details": {},
"timestamp": "2026-11-19T09:30:00Z",
"prev_hash": "prev hash",
"hash": "hash",
"summary": "summary",
"summary_code": "SUM-2026-000142",
"summary_params": {
"key": "value"
}
}
],
"has_more": true,
"next_cursor": "next cursor"
}