List audit logs

Use this endpoint to retrieve all audit log entries. You can filter the results by actor, date range, action type, and entity type. The response uses cursor-based pagination.

GET /v1/governance/audit-logs

List audit logs

cURL

curl --request GET \
  --url https://matcher.sandbox.lerian.net/v1/governance/audit-logs \
  --header 'Authorization: Bearer <token>'

200

Example

{
  "hasMore": true,
  "items": [
    {
      "action": "CREATE",
      "changes": "<array>",
      "createdAt": "2025-01-15T10:30:00Z",
      "entityId": "550e8400-e29b-41d4-a716-446655440002",
      "entityType": "reconciliation_context",
      "hashVersion": 1,
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "originalSize": 0,
      "prevHash": "0000000000000000000000000000000000000000000000000000000000000000",
      "recordHash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
      "tenantId": "550e8400-e29b-41d4-a716-446655440001",
      "tenantSeq": 42,
      "truncated": false,
      "actorId": "[e-mail]"
    }
  ],
  "limit": 20,
  "nextCursor": "eyJpZCI6IjEyMyJ9",
  "prevCursor": "eyJpZCI6IjEyMiJ9"
}

Autorizaciones

Authorization · string · header · requerido

Bearer token authentication (format: "Bearer {token}")

Encabezados

X-Request-Id · string

A unique identifier for tracing the request across services.

Parámetros de consulta

actor · string

Filter by actor ID

date_from · string

Filter logs from this date (YYYY-MM-DD or RFC3339)

date_to · string

Filter logs until this date (YYYY-MM-DD or RFC3339)

action · string

Filter by action type

Ejemplo:

"CREATE"

entity_type · string

Filter by entity type

Ejemplo:

"context"

limit · integer<int64> · predeterminado: 20

The maximum number of items to include in the response. Maximum number of records to return

Rango requerido: 1 <= x <= 200

cursor · string

The cursor value for retrieving the next page of results. Cursor for pagination (opaque)

Respuesta

200

application/json

Indicates that the request was successful and the response contains the expected data.

hasMore · boolean · requerido

Ejemplo:

true

items · object[] | null · requerido

Audit log entries for the current page

Maximum array length: 200

Show child attributes

limit · integer<int64> · requerido

Rango requerido: 1 <= x <= 200

Ejemplo:

20

nextCursor · string

Ejemplo:

"eyJpZCI6IjEyMyJ9"

prevCursor · string

Ejemplo:

"eyJpZCI6IjEyMiJ9"