Skip to main content
GET
/
user
/
get-loan-history
/
{customerId}
Loan History
curl --request GET \
  --url https://{tenant}.fincode.software/api/v1/services/user/get-loan-history/{customerId}
Fetches a comprehensive, paginated history of all loans associated with a customer, providing detailed information about each loan’s status, amounts, and timeline.

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

customerId
string
required
The unique identifier (UUID) of the customer whose loan history to retrieve.

Query Parameters

page
number
default:"1"
Page number for pagination (starts from 1).
size
number
default:"10"
Number of items per page (maximum recommended: 50).

Code Examples

curl --location 'https://finlend.fincode.software/api/v1/services/user/loan-history/123e4567-e89b-12d3-a456-426614174000?page=1&size=10' \
--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'

Path Parameters

customerId
string
required

Query Parameters

page
integer
default:1
size
integer
default:10

Response

200

Loan history retrieved successfully