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

# Create Loan

`POST /v1/loan`

## Headers

- `accept-language` string
- `idempotency-key` string

## Request body

- CreateLoanV1Dto
  - `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.
  - `loanType` 'BNPL' | 'GMV' | 'BNPL_Term' | 'GMV_Term', required — Type of loan. We support these two types, 1. ```BNPL``` - Buyer Financing 2. ```GMV``` - Seller Financing
  - `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.
  - `remark` string — Comments if any.
  - `metadata` string — Metadata for loans. It can be used for reporting, reconciliation purpose.
  - `preApproved` boolean — Flag to create pre-approved loan, Default value will be true.

## Response `200`

Loan created successfully

- CreateDrawdownResponse
  - `statusCode` number, required — The HTTP status code of the error
  - `data` LoanResponse, required
    - `loanId` string, required — Id of the created loan
    - `loanReferenceNo` string, required — Reference Number of the created loan for eg. BNPL***
    - `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
    - `loanType` string, required — Type of loan We support these two types, 1. ```BNPL``` - Buyer Financing 2. ```GMV``` - Seller Financing
    - `loanStatus` string, required — Status of loan We support these three statuses, 1. ```pending-for-approval``` - Loan is pending for approval 2. ```waiting-for-disbursal``` - Loan is pending for disbursal, 3. ```active``` - Loan is active, 4. ```rejected``` - Loan is rejected for some reason, 5. ```closed``` - Loan is paid & closed
    - `disbursalAmount` number, required — Loan Amount
    - `totalDueAmount` number, required — Total Loan Due Amount
    - `loanDueDate` string, required — Loan Due Date in Local Format eg. 21 Aug 2023
    - `loanDueDateUTC` string, required — Loan Due Date in UTC Format eg. 2023-08-20T18:30:00.000Z
    - `dueDatePostGracePeriod` string, required — Loan Due Date with grace period in Local Format eg. 24 Aug 2023
    - `dueDatePostGracePeriodUTC` string, required — Loan Due Date with grace period in UTC Format eg. 2023-08-23T18:30:00.000Z
    - `gracePeriodInDays` number, required — Grace Period(In Days), After which loan goes into overdue.
    - `charges` number, required — Total Monthly Charges(%) Applied on Loan Amount
    - `chargesApplied` number, required — Total Amount of Charges Applied on Loan Amount
    - `customerApprovedCredit` number, required — Customer Approved Credit Line
    - `customerAvailableCredit` number, required — Customer Remaining Credit Line after loan
    - `remark` string, required — Remark given while requesting for loan
    - `metadata` string, required — Metadata for loans. It can be used for reporting, reconciliation purpose.
    - `createdAt` string, required — Created Timestamp of the created loan in UTC Format eg. 2023-03-30T11:46:42.195Z
    - `updatedAt` string, required — Updated Timestamp of the created loan in UTC Format eg. 2023-03-30T11:46:42.195Z
    - `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

---

[API](https://skmtc.net/credilinq/apis/credilinq-apis.md) · [All operations](https://skmtc.net/credilinq/apis/credilinq-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/credilinq/credilinq-apis/revisions/fc4f4dd68f9b/schema)