List audit-log entries scoped to the caller's tenant.

This is the self-service sibling of /v1/admin/audit-logs. The tenant_id filter is pinned to the authenticated tenant at the SQL layer — a client cannot widen…

GET /v1/tenants/{tenant_id}/audit-logs

cURL

curl --request GET \
  --url 'https://api.sync.stateset.com/v1/tenants/{tenant_id}/audit-logs' \
  --header "x-stateset-api-key: $STATESET_SYNC_API_KEY"

200

{
  "items": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "createdAt": "2026-08-31T14:22:05Z",
      "requestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantId": "acme-outdoors",
      "actorEmail": "string",
      "ipAddress": "548 Market St",
      "userAgent": "Mozilla/5.0 (Macintosh)",
      "eventType": "string",
      "event": {}
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalItems": 1,
    "totalPages": 1,
    "hasNext": true,
    "hasPrevious": true
  }
}

This is the self-service sibling of /v1/admin/audit-logs. The tenant_id filter is pinned to the authenticated tenant at the SQL layer — a client cannot widen their view by passing a different tenant_id query param; it simply isn’t accepted. Useful when an agent needs to answer ‘what did I do in the last hour’ without reaching for platform admin credentials.

Path parameters

tenant_id · string · required

Tenant id (must match the authenticated tenant)

Query parameters

page · integer (int32)

Page number (1-indexed)

page_size · integer (int32)

Items per page (max 100)

event_type · string

Filter by event type

resource_type · string

Filter by resource type

actor_email · string

Filter by actor email

Response

object

items · object[] · required

The items on this page

Show items

id · string (uuid) · required

createdAt · string (date-time) · required

requestId · string (uuid)

tenantId · string

actorEmail · string

ipAddress · string

userAgent · string

eventType · string · required

event · object · required

pagination · object · required

Pagination metadata

Show pagination

page · integer · required

Current page number

pageSize · integer · required

Number of items per page

totalItems · integer

Total number of items across all pages

totalPages · integer

Total number of pages

hasNext · boolean · required

Whether there is a next page

hasPrevious · boolean · required

Whether there is a previous page

Status codes

Code	Meaning
200	Audit logs for this tenant
401	Unauthorized
424	Database not configured

cURL

curl --request GET \
  --url 'https://api.sync.stateset.com/v1/tenants/{tenant_id}/audit-logs' \
  --header "x-stateset-api-key: $STATESET_SYNC_API_KEY"

200

{
  "items": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "createdAt": "2026-08-31T14:22:05Z",
      "requestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantId": "acme-outdoors",
      "actorEmail": "string",
      "ipAddress": "548 Market St",
      "userAgent": "Mozilla/5.0 (Macintosh)",
      "eventType": "string",
      "event": {}
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalItems": 1,
    "totalPages": 1,
    "hasNext": true,
    "hasPrevious": true
  }
}