Events

Base URL: $BUSINESS_API

The object

idstring · optional
tenant_idstring · optional
actor_idstring · optional
actor_typestring · optional
actor_namestring · optional

Display label of the actor; the person's name when known, Sistema for a system actor. Not part of the hash chain.

actionstring · optional

Stable action code in English

resource_typestring · optional
resource_idstring · optional
ip_addressstring · optional
user_agentstring · optional
detailsobject · optional
timestampstring (date-time) · optional
prev_hashstring · optional
hashstring · optional
summarystring · optional

Human-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_codestring · optional

Stable code clients translate as audit.<code>: the action when known, change.<resource_type>, or change

summary_paramsobject · optional

Values for the translated summary, such as reference

The object
{
  "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"
  }
}

List audit events

Logs

GET /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

limitinteger · query · optional

Maximum resources to return (default 20, maximum 100).

afterstring · query · optional

Opaque cursor returned by the previous page.

resource_typestring · query · optional

Filter by resource type, e.g. customer, account, property, meter, connection, invoice, payment, ticket, work_order, incident, tariff, onboarding

resource_idstring · query · optional

Filter by resource identifier, for a record page's history

actionstring · query · optional

Filter by exact action code

actor_idstring · query · optional

Filter by actor

fromstring · query · optional

RFC3339 start

tostring · query · optional

RFC3339 end

Returns

200 Audit events, newest first

Show attributes
dataarray of AuditEvent · optional
Show child attributes
idstring · optional
tenant_idstring · optional
actor_idstring · optional
actor_typestring · optional
actor_namestring · optional

Display label of the actor; the person's name when known, Sistema for a system actor. Not part of the hash chain.

actionstring · optional

Stable action code in English

resource_typestring · optional
resource_idstring · optional
ip_addressstring · optional
user_agentstring · optional
detailsobject · optional
timestampstring (date-time) · optional
prev_hashstring · optional
hashstring · optional
summarystring · optional

Human-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_codestring · optional

Stable code clients translate as audit.<code>: the action when known, change.<resource_type>, or change

summary_paramsobject · optional

Values for the translated summary, such as reference

has_moreboolean · optional
next_cursorstring · optional

Errors 403

Permissions audit:read · Roles: admin, analyst, owner

curl -X GET "$BUSINESS_API/events" \
  -H "Authorization: Bearer sk_test_..."
Response 200
{
  "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"
}

Verify audit log cryptographic hash-chain integrity

Logs

GET /events/verify

Walks the tenant's entire audit chain in sequence order, checking each event's link to the previous hash and recomputing its payload hash. Always answers 200: verified is true with the event count and last hash when the chain is intact, or false with tampered_event_id and failure_reason (broken prev_hash linkage or payload hash mismatch) at the first bad event. An empty chain verifies with zero events. Requires the audit:verify permission.

Returns

200 Ledger verification result

Errors 403

Permissions audit:verify · Roles: admin, owner

curl -X GET "$BUSINESS_API/events/verify" \
  -H "Authorization: Bearer sk_test_..."
Response 200

Ledger verification result