Skip to main content
GET
/
v1
/
governance
/
audit-logs
List audit logs
curl --request GET \
  --url https://matcher.sandbox.lerian.net/v1/governance/audit-logs \
  --header 'Authorization: Bearer <token>'
{
  "hasMore": true,
  "items": [
    {
      "action": "CREATE",
      "actorId": "[email protected]",
      "changes": [
        123
      ],
      "createdAt": "2025-01-15T10:30:00.000Z",
      "entityId": "550e8400-e29b-41d4-a716-446655440002",
      "entityType": "reconciliation_context",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "tenantId": "550e8400-e29b-41d4-a716-446655440001"
    }
  ],
  "limit": 20,
  "nextCursor": "eyJpZCI6IjEyMyJ9",
  "prevCursor": "eyJpZCI6IjEyMiJ9"
}

Authorizations

Authorization
string
header
required

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

Headers

X-Request-Id
string

A unique identifier for tracing the request across services.

Query Parameters

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

entity_type
string

Filter by entity type

limit
integer
default:20

The maximum number of items to include in the response.

Required range: 1 <= x <= 200
cursor
string

The cursor value for retrieving the next page of results.

Response

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

Paginated list of audit log entries

hasMore
boolean
Example:

true

items
object[]

List of audit log entries

limit
integer
Required range: 1 <= x <= 200
Example:

20

nextCursor
string
Example:

"eyJpZCI6IjEyMyJ9"

prevCursor
string
Example:

"eyJpZCI6IjEyMiJ9"