---
title: "Preview Loan"
method: POST
path: "/v1/loan/calculateloanschedule"
tags: ["Loans"]
---

# Preview Loan

`POST /v1/loan/calculateloanschedule`

## Request

- Base URL: `https://api.credilinq.ai`
- URL: `https://api.credilinq.ai/v1/loan/calculateloanschedule`
- Auth: HTTP bearer

## Headers

- `accept-language` string

## Request body

- CalculateLoanScheduleV1Dto
  - `customerReferenceNo` string, required: Customer Reference number. Each customer has unique reference number. Enter reference number of the customer for whom loan should be created. - ``` /^S*$/ ```
  - `loanAmount` number, required: Loan Amount. - Support decimal values as well.
  - `loanTerm` 30 | 45 | 60 | 90 | 120 | 150 | 180 | 210 | 240 | 270 | 300 | 330 | 360, required: Duration of the loan. Based on loan terms selected at the cusomer level, The customer for whom loan is being created should be.
  - `loanType` 'BNPL' | 'GMV' | 'BNPL_Term' | 'GMV_Term', required: Type of loan. We support these two types, 1. ```BNPL``` - Buyer Financing 2. ```GMV``` - Seller Financing

## Response `200`

Preview Your Loan Details

- GetCalculateLoanResponse
  - `statusCode` number, required: The HTTP status code of the error
  - `data` CalculateLoanResponse, required
    - `customerReferenceNo` string, required: Customer Reference number, for which loan is created
    - `loanTerm` 30 | 45 | 60 | 90 | 120 | 150 | 180 | 210 | 240 | 270 | 300 | 330 | 360, required: Duration of the loan. Based on loan terms selected at the cusomer level, The customer for whom loan is being created should be
    - `totalDueAmount` number, required: Total Loan Due Amount
    - `loanDueDate` string, required: Total Loan Due Amount in UTC Format eg. 2023-03-30T11:46:42.195Z
    - `disbursalAmount` number, required: Loan Amount
    - `chargesApplied` number, required: Total Amount of Charges Applied on Loan Amount
    - `totalRepaymentExpected` number, required: Total Repayment Expected
    - `currency` string, required: Currency Code
  - `message` string, required: Human-readable message containing all available details about the operation
  - `success` boolean, required: A boolean indicating whether this was a success response or an error response

## Other responses

- `400`: Invalid Request
- `401`: Invalid credentials
- `403`: Forbidden resource
- `404`: Requested Data Not Found
- `500`: Internal Server Error, Some problem is there, please try after sometime

## Changes

- **2026-11-03** `9c7459ed471b`: 1 info
  - the `loanDueDate` response's property default value changed from `2026-10-22T10:32:50.369Z` to `2026-11-03T05:12:55.498Z` for the status `200`
- **2026-10-22** `2e0ba4079f74`: 1 info
  - the `loanDueDate` response's property default value changed from `2026-10-13T13:38:11.999Z` to `2026-10-22T10:32:50.369Z` for the status `200`
- **2026-10-13** `17f3cf297b38`: 1 info
  - the `loanDueDate` response's property default value changed from `2026-09-30T04:58:55.515Z` to `2026-10-13T13:38:11.999Z` for the status `200`
- **2026-09-30** `7083bc5fea4e`: 1 info
  - the `loanDueDate` response's property default value changed from `2026-09-29T04:49:52.624Z` to `2026-09-30T04:58:55.515Z` for the status `200`
- **2026-09-29** `f3890bf4b73f`: 1 info
  - the `loanDueDate` response's property default value changed from `2026-09-14T10:27:22.817Z` to `2026-09-29T04:49:52.624Z` for the status `200`

[Operation history](https://skmtc.dev/credilinq/apis/credilinq-apis/changes/v1/loan/calculateloanschedule/post.md)

---

[API](https://skmtc.dev/credilinq/apis/credilinq-apis.md) - [All operations](https://skmtc.dev/credilinq/apis/credilinq-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/credilinq/apis/credilinq-apis/revisions/9c7459ed471b?raw)