Skip to main content

List Loans Request

This API is invoked by the Lender to return the details of the loans.

Request Body
metadata object REQUIRED

Metadata specific to each API request.

version string REQUIRED
originatorOrgId string

The organisation id on the Participant Registry.

originatorParticipantId string

The participant id on the Participant Registry. This will be different for every role under the same organisation.

timestamp string REQUIRED
traceId string REQUIRED
requestId string REQUIRED

UUID used to tie request and response and for idempotency

productData object REQUIRED

Product Metadata specific to each API request.

productId string REQUIRED

The product id on the Product Registry.

productNetworkId string

The product network id on the Product Registry.

response object REQUIRED
error string REQUIRED
loans object[] REQUIRED
loanId string REQUIRED
loanStatus string

Possible values: [EMI_DUE, EMI_PAID, EMI_OVERDUE, EMI_WAIVED, LOAN_CLOSED, NPA, PARTIALLY_PAID, PRECLOSURE, SETTLEMENT_STARTED, SETTLEMENT_COMPLETED, SETTLEMENT_FAILED, SETTLEMENT_PAID, HEALTHY]

terms object REQUIRED
requestedAmount float REQUIRED
currency string REQUIRED
sanctionedAmount float
netDisbursedAmount float
interestType string

Possible values: [FIXED, FLOATING]

interestRate float
annualPercentageRate float
coolingOffPeriod object
duration number REQUIRED
unit string REQUIRED

Possible values: [MONTH, DAY, YEAR]

totalRepayableAmount float
interestAmount float
description string
tenure object
duration number REQUIRED
unit string REQUIRED

Possible values: [MONTH, DAY, YEAR]

legalAgreement object
type string REQUIRED

Possible values: [TEXT, DOCUMENT_URL, REDIRECT_TO_LENDER_URL]

data string REQUIRED
documents object[]
id string
source string REQUIRED

Possible values: [GSTN, AA, FIP, FSR, FIU, USER, OTHER]

sourceIdentifier string REQUIRED
format string REQUIRED

Possible values: [JSON, DOC, IMAGE, CSV, XML, PDF, URL]

reference string REQUIRED
type string REQUIRED

Possible values: [GST_PROFILE, GSTN_B2B_INVOICE, PAN, AADHAAR, DRIVING_LICENSE, PASSPORT, OTHER]

isDataInline boolean REQUIRED
data string REQUIRED
charges object
prepayment object
chargeType string REQUIRED

Possible values: [FIXED_AMOUNT, RATE_BASED]

data object REQUIRED
rate float
amount float
applicableParameter string

Possible values: [TOTAL_LOAN_AMOUNT, OUTSTANDING_PAYABLE_AMOUNT, EMI, REPAYMENT_PRINCIPAL]

description string
url string
url string
extensibleData object

This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements.

bounce object
chargeType string REQUIRED

Possible values: [FIXED_AMOUNT, RATE_BASED]

data object REQUIRED
rate float
amount float
applicableParameter string

Possible values: [TOTAL_LOAN_AMOUNT, OUTSTANDING_PAYABLE_AMOUNT, EMI, REPAYMENT_PRINCIPAL]

description string
url string
url string
extensibleData object

This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements.

latePayment object
chargeType string REQUIRED

Possible values: [FIXED_AMOUNT, RATE_BASED]

data object REQUIRED
rate float
amount float
applicableParameter string

Possible values: [TOTAL_LOAN_AMOUNT, OUTSTANDING_PAYABLE_AMOUNT, EMI, REPAYMENT_PRINCIPAL]

description string
url string
url string
extensibleData object

This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements.

processing object
chargeType string REQUIRED

Possible values: [FIXED_AMOUNT, RATE_BASED]

data object REQUIRED
rate float
amount float
applicableParameter string

Possible values: [TOTAL_LOAN_AMOUNT, OUTSTANDING_PAYABLE_AMOUNT, EMI, REPAYMENT_PRINCIPAL]

description string
url string
url string
extensibleData object

This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements.

other object
chargeType string REQUIRED

Possible values: [FIXED_AMOUNT, RATE_BASED]

data object REQUIRED
rate float
amount float
applicableParameter string

Possible values: [TOTAL_LOAN_AMOUNT, OUTSTANDING_PAYABLE_AMOUNT, EMI, REPAYMENT_PRINCIPAL]

description string
url string
url string
extensibleData object

This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements.

url string
extensibleData object

This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements.

Responses
200

Acknowledgement of Request Received

Schema OPTIONAL
error string
traceId string
timestamp string