Reschedule loan account

Appends an immutable rescheduled schedule version and recalculation trigger. Idempotency is enforced by the lib-commons idempotency middleware via the X-Idempotency header; a reused key with different facts yields 409. A malformed UUID yields 422.

POST /api/v1/loan-accounts/{id}/reschedules

Reschedule loan account

cURL

curl --request POST \
  --url https://lender.sandbox.lerian.net/api/v1/loan-accounts/{id}/reschedules \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "businessDate": "<string>",
  "effectiveDate": "<string>",
  "firstRescheduledDueDate": "<string>",
  "newTermMonths": 2,
  "reason": "<string>",
  "transactionId": "<string>"
}
'

201

{
  "previousScheduleVersionId": "<string>",
  "scheduleVersion": {
    "createdAt": "<string>",
    "id": "<string>",
    "installments": [
      {
        "dueDate": "<string>",
        "feesAmount": "<string>",
        "interestAmount": "<string>",
        "number": 123,
        "penaltiesAmount": "<string>",
        "principalAmount": "<string>",
        "principalRemaining": "<string>",
        "totalAmount": "<string>"
      }
    ],
    "loanAccountId": "<string>",
    "reason": "<string>",
    "triggerTransactionId": "<string>",
    "versionNumber": 123,
    "predecessorVersionId": "<string>"
  }
}

Authorizations

Authorization · string · header · required

JWT bearer token issued by the identity provider.

Headers

X-Idempotency · string · required

Canonical idempotency request ID. Enforced by the lib-commons idempotency middleware.

Example:

"550e8400-e29b-41d4-a716-446655440011"

Path Parameters

id · string<uuid> · required

Loan account identifier (UUID).

Example:

"550e8400-e29b-41d4-a716-446655440000"

Body

application/json

businessDate · string · required

YYYY-MM-DD business date applied to the reschedule.

Example:

"2026-06-14"

effectiveDate · string · required

YYYY-MM-DD effective date of the reschedule.

Example:

"2026-06-14"

firstRescheduledDueDate · string · required

YYYY-MM-DD first due date of the rescheduled plan.

Example:

"2026-06-14"

newTermMonths · integer<int64> · required

New loan term in months.

Required range: x >= 1

Example:

24

reason · string · required

Operator-supplied reschedule reason.

Maximum string length: 128

transactionId · string · required

Operator-supplied reschedule transaction identifier.

Maximum string length: 128

Response

201

application/json

Created

previousScheduleVersionId · string · required

Predecessor schedule version UUID.

Example:

"550e8400-e29b-41d4-a716-446655440031"

scheduleVersion · object · required

The newly appended immutable schedule version.

Show child attributes