---
title: "Simulate early final settlement"
method: POST
path: "/v2/loans/{loanId}/early-settlement/simulate"
tags: ["Early final settlement"]
---

# Simulate early final settlement

`POST /v2/loans/{loanId}/early-settlement/simulate`

## Request

- Base URL: `https://sandbox.pismolabs.io/lending`
- URL: `https://sandbox.pismolabs.io/lending/v2/loans/{loanId}/early-settlement/simulate`
- Auth: HTTP bearer

Simulate an early final settlement (EFS) for a loan. Optionally calculate present value with a future reference date

## Path parameters

- `loanId` string, uuid, required

## Request body

- EarlyFinalSettlementV2Request: Request body for early final settlement simulation
  - `reference_date` string, date: Reference date of the installment. Format = YYYY-MM-DD.
  - `waive_penalty` boolean: Waive the penalty for early settlement?

## Response `201`

Simulation created

- EarlyFinalSettlementV2Response
  - `early_settlement_id` string, uuid, required: Early settlement simulation ID
  - `outstanding` OutstandingResponse, required: Outstanding amount of a loan
    - `charge` number, double: Outstanding charge
    - `fee` number, double: Fee amount
    - `installments` integer: Number of outstanding installments
    - `interest` number, double: Interest amount
    - `penalty` number, double: Calculation penalty early settlement
    - `principal` number, double: Principal amount
    - `tax` number, double: Tax amount
  - `settlement_total` number, double, required: Total amount to settle the loan

## Other responses

- `400`: A validation error occurred.
- `404`: Resource not found
- `500`: Internal server error

---

[API](https://skmtc.dev/pismo/apis/lending.md) - [All operations](https://skmtc.dev/pismo/apis/lending/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/lending/revisions/a288022e3d8b?raw)