Loan Application Details

Retrieves comprehensive details of a loan application including full application information and loan product name.

GET /api/v1/services/user/loan-application-details/{loan-application-id}

cURL GET

[https://finlend.fincode.software/api/v1/services/user/loan-application-details/{loan-application-id}](https://finlend.fincode.software/api/v1/services/user/loan-application-details/{loan-application-id})

200

{
  "status": "<string>",
  "data": {
    "loanDetails": {
      "id": "<string>",
      "dateOfRequest": "<string>",
      "loanRequestUserId": "<string>",
      "loanProduct": "<string>",
      "organisation": "<string>",
      "loanApplicationStatusEnum": "<string>",
      "requestedLoanAmount": 123,
      "loanDuration": 123,
      "loanRepaymentMethodEnum": "<string>",
      "customerCreditAccountId": "<string>",
      "employmentStatus": "<string>",
      "monthlyIncome": 123,
      "currencyCode": "<string>",
      "durationCounter": "<string>",
      "customerName": "<string>",
      "email": "<string>",
      "loanApplicationId": "<string>",
      "phoneNumber": "<string>",
      "dateOfBirth": "<string>"
    },
    "loanProductName": "<string>"
  }
}

Fetches detailed information about a loan application including all application fields, customer information, loan terms, and the associated loan product name.

cURL GET

[https://finlend.fincode.software/api/v1/services/user/loan-application-details/{loan-application-id}](https://finlend.fincode.software/api/v1/services/user/loan-application-details/{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 to retrieve.

Response

Returns comprehensive loan application details including full application information and loan product name.

status · string · default: "SUCCESS"

Overall status of the API request.

data · object

Response object containing loan details and product name.

Show data object

loanDetails · object

Complete loan application details.

Show loanDetails object

id · string

Unique identifier of the loan application.

dateOfRequest · string

Date when the loan application was created.

loanRequestUserId · string

Unique identifier of the user who requested the loan.

loanProduct · string

Unique identifier of the loan product.

organisation · string

Unique identifier of the organisation.

loanApplicationStatusEnum · string

Current status of the loan application (e.g., REQUESTED, APPROVED, OFFER_SENT, ACCEPTED, DISBURSED).

requestedLoanAmount · number

The loan amount requested by the customer.

loanDuration · number

Loan duration.

loanRepaymentMethodEnum · string

Repayment method (e.g., External Bank Transfer, Internal Bank Transfer).

customerCreditAccountId · string

Unique identifier of the customer’s credit account.

employmentStatus · string

Customer’s employment status.

monthlyIncome · number

Customer’s monthly income.

currencyCode · string

Currency code with symbol (e.g., NGN (₦)).

durationCounter · string

Duration counter unit (e.g., MONTH, WEEK, DAY).

customerName · string

Customer’s name.

email · string

Customer’s email address.

loanApplicationId · string

Loan application identifier.

phoneNumber · string

Customer’s phone number.

dateOfBirth · string

Customer’s date of birth.

loanProductName · string

Name of the loan product associated with this application.

Code Examples

cURL

curl --location 'https://finlend.fincode.software/api/v1/services/user/loan-application-details/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'