API endpoints
Audit Logs API
The Audit Logs API provides a combined, organization-scoped feed from identity, billing, ledger, MPC, authentication, and administration domains.
List audit logs
GET /api/v1/orgs/{orgId}/audit-logs
Required scope: audit-logs:read
The API key must be authorized for the organization identified by orgId.
Filters
| Parameter | Purpose |
|---|---|
sources | Filter by identity, billing, ledger, mpc, auth, or admin |
actions | Filter by one or more actions |
actorType, actorId | Select a human, API key, administrator, or other actor |
objectType | Filter by affected object type |
ip | Filter by client IP |
createdFrom, createdTo | Restrict the creation-time range |
snapshotAt | Freeze the result window for stable pagination |
sortOrder | Choose result order |
page, limit | Page-based pagination |
Use the same snapshotAt value while traversing a multi-page result set so new log entries do not shift page boundaries.
Audit item
Items include the source, actor identity, organization, action, object, IP, user agent, authentication outcome or failure reason, and createdAt. The combined public response excludes source payloads.
Retention guidance
Persist the API requestId when reporting errors. Export audit data according to your own retention and regulatory requirements; API availability does not replace your organization's evidence-retention policy.