Get Loan Terms

Retrieves the loan terms and conditions for a specific organization.

GET /api/v1/services/user/get-loan-terms/{organisationId}

cURL GET

[https://finlend.fincode.software/api/v1/services/user/get-loan-terms/{organisationId}](https://finlend.fincode.software/api/v1/services/user/get-loan-terms/{organisationId})

200

{
  "status": "<string>",
  "data": {
    "organisationId": "<string>",
    "termsAndConditions": "<string>",
    "interestRateRange": {},
    "feeStructure": {},
    "repaymentTerms": {},
    "eligibilityCriteria": {},
    "lastUpdated": "<string>"
  }
}

Fetches the loan terms and conditions, including interest rates, fees, repayment schedules, and other important terms that apply to loans from a specific organization.

cURL GET

[https://finlend.fincode.software/api/v1/services/user/get-loan-terms/{organisationId}](https://finlend.fincode.software/api/v1/services/user/get-loan-terms/{organisationId})

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

organisationId · string · required

The unique identifier (UUID) of the organization whose loan terms to retrieve.

Response

Returns the loan terms and conditions for the organization.

status · string · default: "SUCCESS"

Overall status of the API request.

data · object

Loan terms and conditions details.

Show data object

organisationId · string

Unique identifier of the organization.

termsAndConditions · string

Full text of the terms and conditions.

interestRateRange · object

Range of interest rates applicable.

feeStructure · object

Details of fees applicable to loans.

repaymentTerms · object

Information about repayment schedules and options.

eligibilityCriteria · object

Criteria that customers must meet to qualify for loans.

lastUpdated · string

Date when the terms were last updated.

Code Examples

cURL

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