Skip to main content
GET
https://finlend.fincode.software
/
api
/
v1
/
services
/
user
/
loan-details-with-payment-history
/
{loan-application-id}
[https://finlend.fincode.software/api/v1/services/user/loan-details-with-payment-history/{loan-application-id}](https://finlend.fincode.software/api/v1/services/user/loan-details-with-payment-history/{loan-application-id})
{
  "status": "<string>",
  "data": {
    "loanApplicationId": "<string>",
    "customerId": "<string>",
    "customerName": "<string>",
    "customerEmail": "<string>",
    "loanProductName": "<string>",
    "loanApplicationStatus": "<string>",
    "accountState": "<string>",
    "loanAmount": 123,
    "interestRate": 123,
    "totalRepaymentAmount": 123,
    "totalBalance": 123,
    "principalBalance": 123,
    "interestBalance": 123,
    "feesBalance": 123,
    "penaltyBalance": 123,
    "totalAmountPaid": 123,
    "principalPaid": 123,
    "interestPaid": 123,
    "feesPaid": 123,
    "penaltyPaid": 123,
    "applicationDate": "<string>",
    "disbursementDate": "<string>",
    "firstInstallmentDate": "<string>",
    "maturityDate": "<string>",
    "nextPaymentDueDate": "<string>",
    "totalInstallments": 123,
    "installmentsPaid": 123,
    "installmentsRemaining": 123,
    "loanDuration": 123,
    "durationCounter": "<string>",
    "loanRepaymentMethod": "<string>",
    "isThirdPartyPayment": true,
    "repaymentBankName": "<string>",
    "repaymentAccountNumber": "<string>",
    "repaymentAccountName": "<string>",
    "loanFullyRepaid": true,
    "currencyCode": "<string>",
    "paymentHistory": [
      {
        "installmentNumber": 123,
        "dueDate": "<string>",
        "installmentAmount": 123,
        "principalAmount": 123,
        "interestAmount": 123,
        "feesAmount": 123,
        "penaltyAmount": 123,
        "amountPaid": 123,
        "outstandingAmount": 123,
        "paymentStatus": "<string>",
        "paymentDate": "<string>",
        "daysOverdue": 123
      }
    ]
  }
}
Fetches detailed information about a loan application including all installments, payment history, outstanding balances, and repayment schedule.
[https://finlend.fincode.software/api/v1/services/user/loan-details-with-payment-history/{loan-application-id}](https://finlend.fincode.software/api/v1/services/user/loan-details-with-payment-history/{loan-application-id})

Request Headers

X-Auth-Token
string
required
The JWT Access Token obtained from the /login or /refresh-token endpoint.
x-idempotency-key
string
required
Unique idempotency key for the request to prevent duplicate processing.
x-fapi-auth-date
string
required
The date and time at which the request was initiated (ISO 8601 format).
x-fapi-customer-ip-address
string
required
The IP address of the customer making the request.
x-fapi-interaction-id
string
required
Unique identifier for the interaction/session.

Path Parameters

loan-application-id
string
required
The unique identifier (UUID) of the loan application for which to retrieve details.

Response

Returns comprehensive loan details including installment schedule and payment history.
status
string
default:"SUCCESS"
Overall status of the API request.
data
object
Loan application details with payment history.

Code Examples

curl --location 'https://finlend.fincode.software/api/v1/services/user/loan-details-with-payment-history/123e4567-e89b-12d3-a456-426614174000' \
--header 'X-Auth-Token: YOUR_JWT_ACCESS_TOKEN' \
--header 'x-idempotency-key: unique-key-12345' \
--header 'x-fapi-auth-date: 2024-01-15T10:30:00Z' \
--header 'x-fapi-customer-ip-address: 192.168.1.1' \
--header 'x-fapi-interaction-id: interaction-12345'