> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # List audit records > The append-only audit trail of privileged mutations (obligations, configuration changes, relayed messages, access), keyset-paged newest occurred first. Filterable by occurred_at range (from/to, inclusive), action type, and participant ISPB. Every field is a stored column projected verbatim — no counts, no aggregates, no derived durations (D-4). Read-only: the trail is never mutated through this surface. ## OpenAPI ````yaml pt/openapi/v3-current/siloc.yaml get /api/v1/siloc/audit-records openapi: 3.1.0 info: description: >- Interface OpenAPI 3.1 do Lerian SILOC, o trilho do lado do participante que conecta a instituição à liquidação interbancária diferida por compensação SILOC da Núclea. Abrange as capacidades de cobertura de liquidação, o registro de participantes e seu status operacional, o ciclo de vida dos certificados regulados, o relay de mensagens do domínio de cartões e seu status, o reenvio administrativo de falhas de relay estacionadas, os ciclos OT e as rodadas de recálculo, as instruções de liquidação, a ingestão de ROC, os alertas operacionais, as mudanças de agenda de contingência, a leitura do calendário de dias úteis e a trilha de auditoria. title: Lerian SILOC API version: 1.0.0 servers: - url: http://localhost:9820 security: [] paths: /api/v1/siloc/audit-records: get: tags: - Audit summary: List audit records description: >- The append-only audit trail of privileged mutations (obligations, configuration changes, relayed messages, access), keyset-paged newest occurred first. Filterable by occurred_at range (from/to, inclusive), action type, and participant ISPB. Every field is a stored column projected verbatim — no counts, no aggregates, no derived durations (D-4). Read-only: the trail is never mutated through this surface. operationId: listAuditRecords parameters: - description: Inclusive lower bound on occurred_at (RFC 3339); omit for unbounded. explode: false in: query name: from schema: description: >- Inclusive lower bound on occurred_at (RFC 3339); omit for unbounded. format: date-time type: string - description: Inclusive upper bound on occurred_at (RFC 3339); omit for unbounded. explode: false in: query name: to schema: description: >- Inclusive upper bound on occurred_at (RFC 3339); omit for unbounded. format: date-time type: string - description: Filter by exact action type. explode: false in: query name: actionType schema: description: Filter by exact action type. type: string - description: Filter by exact participant ISPB (8 digits). explode: false in: query name: participantIspb schema: description: Filter by exact participant ISPB (8 digits). pattern: ^[0-9]{8}$ type: string - description: Opaque pagination cursor. explode: false in: query name: cursor schema: description: Opaque pagination cursor. type: string - description: Page size (default 50, max 200). explode: false in: query name: limit schema: default: 50 description: Page size (default 50, max 200). format: int64 maximum: 200 minimum: 1 type: integer responses: '200': content: application/json: schema: $ref: '#/components/schemas/AuditRecordListResponse' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error security: - BearerAuth: [] components: schemas: AuditRecordListResponse: additionalProperties: false properties: hasMore: description: Whether more pages follow. type: boolean items: description: The page of audit records (never null; empty when nothing matches). items: $ref: '#/components/schemas/AuditRecordResponse' type: - array - 'null' nextCursor: description: >- Opaque cursor for the next page; omitted when the trail is exhausted. type: string required: - items - hasMore type: object Detail: additionalProperties: false properties: code: description: >- Stable, machine-readable domain error code scoped to the emitting service (format: -NNNN). examples: - ERR-0001 type: string detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string type: object AuditRecordResponse: additionalProperties: false properties: actionType: description: Canonical action constant (e.g. OT_CYCLE_SETTLED). examples: - OT_CYCLE_SETTLED type: string actorId: description: Principal or service that performed the action. type: string correlationId: description: Request/flow correlation id. type: string createdAt: description: When the row was written (DB clock). format: date-time type: string details: description: >- Provenance JSONB object (source_event_id / provenance / before / after), projected verbatim; omitted when the stored column is NULL. Holds no raw payloads or PII by the write-side port contract. id: description: Audit record id (writer-supplied UUIDv7). format: uuid type: string occurredAt: description: When the action happened. format: date-time type: string participantIspb: description: Participant the action scopes to (8 digits); omitted when NULL. type: string resourceId: description: Specific resource id; omitted when the stored column is NULL. type: string resourceType: description: Affected resource kind. type: string summary: description: Human-readable one-line description. type: string required: - id - actorId - actionType - resourceType - summary - correlationId - occurredAt - createdAt type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object securitySchemes: BearerAuth: bearerFormat: JWT description: JWT bearer token issued by the identity provider. scheme: bearer type: http ````