---
title: "Reverse loan account transaction"
method: POST
path: "/api/v1/loan-accounts/{id}/transactions/{transactionId}/reverse"
tags: ["Loan Accounts"]
---

# Reverse loan account transaction

`POST /api/v1/loan-accounts/{id}/transactions/{transactionId}/reverse`

Creates an immutable compensating transaction and preserves reversal lineage. Idempotency is enforced in the use case via the X-Request-ID header (X-Idempotency fallback): a reused request ID with different facts yields 409. A malformed UUID yields 422; an unknown transaction yields 404.

## Path parameters

- `id` string, uuid, required — Loan account identifier (UUID).
- `transactionId` string, uuid, required — Original repayment transaction identifier (UUID).

## Headers

- `X-Request-ID` string — Canonical idempotency request ID. Falls back to X-Idempotency when absent.
- `X-Idempotency` string — Fallback idempotency request ID used when X-Request-ID is absent.

## Request body

- ReverseRepaymentHumaRequest
  - `effectiveDate` string, required — YYYY-MM-DD effective date of the reversal.
  - `jurisdictionCode` string — Optional jurisdiction code.
  - `profileVersion` string, required — Product profile version applied to the reversal.
  - `reason` string, required — Operator-supplied reversal reason.

## Response `200`

OK

- ReverseRepaymentHumaBody
  - `amount` string, required — Reversed amount (2 d.p. string).
  - `effectiveDate` string, required — ISO-8601 effective date of the reversal.
  - `jurisdictionCode` string — Jurisdiction code applied to the reversal.
  - `loanAccountId` string, required — Loan account UUID.
  - `originalTransactionId` string, required — Reversed original transaction UUID.
  - `profileVersion` string, required — Product profile version applied to the reversal.
  - `reason` string, required — Operator-supplied reversal reason.
  - `requestId` string — Idempotency request ID echoed from the request.
  - `transactionId` string, required — Compensating reversal transaction UUID.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)