---
title: "List loan account audit events"
method: GET
path: "/api/v1/loan-accounts/{id}/audit-events"
tags: ["Loan Accounts"]
---

# List loan account audit events

`GET /api/v1/loan-accounts/{id}/audit-events`

## Request

- Base URL: `https://identity.sandbox.lerian.net`
- URL: `https://identity.sandbox.lerian.net/api/v1/loan-accounts/{id}/audit-events`
- Auth: none required
- TypeScript: <https://skmtc.dev/lerian/apis/identity-plugin/docs/api/v1/loan-accounts/:id/audit-events/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns immutable correction, replay, and operator-visible audit history for a loan account. Schema-bounded limit (1–100, default 50); out-of-range values yield 422. A malformed UUID yields 422 (schema error).

## Path parameters

- `id` string, uuid, required: Loan account identifier (UUID).

## Query parameters

- `limit` integer: Maximum audit events to return (1–100, default 50).

## Response `200`

OK

- LoanAuditHistoryHumaBody
  - `data` LoanAuditEventHumaBody[], nullable, required: Ordered immutable audit history events.
    - `amount` string, required: Event amount (2 d.p. string).
    - `eventType` string, required: Audit event kind (e.g. original_repayment, reversal).
    - `lineage` LoanAuditLineageHumaBody[], nullable, required: Ordered lineage links for this event.
      - `relation` string, required: Lineage relation type (e.g. reverses, replays_after_reversal).
      - `transactionId` string, required: Identifier of the transaction this lineage link points to.
    - `occurredAt` string, required: RFC 3339 UTC timestamp of the event.
    - `operatorNote` string, required: Human-readable note explaining this event for operators.
    - `scheduleVersionId` string: Identifier of the schedule version in effect for this event; omitted when not applicable.
    - `sequence` integer, required: Monotonic per-account ordering position of this event in the audit history.
    - `transactionId` string: Identifier of the transaction this event relates to; omitted for events with no transaction.
  - `operatorSummary` string, required: Human-readable operator summary of the audit history.

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/lerian/apis/identity-plugin.md) - [All operations](https://skmtc.dev/lerian/apis/identity-plugin/llms.txt) - [OpenAPI document](https://skmtc.dev/lerian/apis/identity-plugin/revisions/25daba385532?raw)