---
title: "Get Active Loans"
method: GET
path: "/v1/customer/{customerReferenceNo}/loans"
tags: ["Customers"]
---

# Get Active Loans

`GET /v1/customer/{customerReferenceNo}/loans`

## Path parameters

- `customerReferenceNo` string, required

## Headers

- `accept-language` string

## Response `200`

Get customer's active loans

- CustomerActiveLoansResponse
  - `statusCode` number, required — The HTTP status code of the error
  - `data` LoanSummaryResponse[], required — Response Data from the operation
    - `loanId` string, required — Id of the created loan
    - `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
    - `loanReferenceNo` string, required — Loan Reference number
    - `loanType` string, required — Type of loan We support these 4 types, 1. ```BNPL``` - Buyer Financing 2. ```BNPL_Term``` - Buyer Financing Term Loan 3. ```GMV``` - Seller Financing 4. ```GMV_Term``` - Seller Financing Term Loan
    - `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
    - `loanAmount` number, required — Loan Amount
    - `totalServiceFee` number, required — Total Service fee applied on loan
    - `totalServiceFeeDue` number, required — Total Service fee Due for loan
    - `expectedRepaymentAmount` number, required — Total Expected Repayment Amount
    - `totalDueAmount` number, required — Total Due amount that is remaining to repay
    - `loanDueDate` string, required — Loan Due Date eg. 18 September 2023
    - `dueDatePostGracePeriod` string, required — Due date with Grace Period, eg. Loan Due date is 18 September 2023, and grace period is 3 days. so dueDatePostGracePeriod will be 21 September 2023
    - `gracePeriodInDays` number, required — Grace Period(In Days), After which loan goes into overdue.
    - `totalPenaltyDue` number, required — Penalty outstanding that needs to repay
    - `currency` string, required — Currency Code
    - `requestedDate` string, required — Loan Due Date eg. 18 Aug 2023
    - `repaymentSchedule` RepaymentScheduleV2Response[], required — Repayment schedule for loan
      - `dueDate` string, required — Loan Due Date eg. 18 September 2023
      - `totalDueForPeriod` number, required — Total due payment for current period
      - `penaltyDueForPeriod` number, required — Total due penalty for current period
      - `totalServiceFeeForPeriod` number, required — Total Service fee for current period
      - `totalServiceFeeDueForPeriod` number, required — Total Service fee due for current period
      - `principalDueForPeriod` number, required — Total due principal for current period
      - `dueDatePostGracePeriod` string, required — Due date with grace period eg. 21 September 2023
      - `paid` boolean, required — indicates that payment is completed or not
    - `payments` LoanPayment[], required — All payments done by customer for the loan
      - `paymentId` string, required — Id of the payment
      - `paymentDate` string, required — Date of the payment in UTC Format eg. 2023-03-30T11:46:42.195Z
      - `paymentAmount` number, required — Payment Amount
      - `paymentMethod` string, required — Payment Amount
      - `paymentReferenceNo` string, required — Payment reference number provided while making payment
      - `accountNumber` string, required — Account Number varies based on payment types. So for bank transfer payment( this field will contain ```bank account number``` & for UEN number payment this will contain ```UEN Number```
      - `accountName` string, required — Account Name to which payment has been made.
      - `bankName` string, required — Bank Name varies based on payment types. So for bank transfer payment this field will be present, for rest of the types it will be empty
      - `bankSwiftCode` string, required — Bank Swift Code varies based on payment types. So for bank transfer payment this field will be present, for rest of the types it will be empty
      - `paymentStatus` number, required — We have 3 types of payment status codes. For payment rejected: ```0``` For payment done, but verification pending: ```1``` For payment done & verified: ```2```
      - `loanId` string, required — Loan Id, for which payment has been made.
      - `customerReferenceNo` string, required — Customer Reference Number, for which payment has been made.
      - `metadata` string, required — Metadata for payments. It can be used for reporting, reconciliation purpose.
      - `createdAt` string, required — Created Timestamp of the payment in UTC Format eg. 2023-03-30T11:46:42.195Z
      - `updatedAt` string, required — Updated Timestamp of the payment 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)
