Loan History

Loan History

curl --request GET \
  --url https://{tenant}.fincode.software/api/v1/services/user/get-loan-history/{customerId}

const options = {method: 'GET'};

fetch('https://{tenant}.fincode.software/api/v1/services/user/get-loan-history/{customerId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{tenant}.fincode.software/api/v1/services/user/get-loan-history/{customerId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenant}.fincode.software/api/v1/services/user/get-loan-history/{customerId}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://{tenant}.fincode.software/api/v1/services/user/get-loan-history/{customerId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

GET

user

get-loan-history

{customerId}

Loan History

curl --request GET \
  --url https://{tenant}.fincode.software/api/v1/services/user/get-loan-history/{customerId}

const options = {method: 'GET'};

fetch('https://{tenant}.fincode.software/api/v1/services/user/get-loan-history/{customerId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{tenant}.fincode.software/api/v1/services/user/get-loan-history/{customerId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenant}.fincode.software/api/v1/services/user/get-loan-history/{customerId}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://{tenant}.fincode.software/api/v1/services/user/get-loan-history/{customerId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

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

string

required

The JWT Access Token obtained from the /login or /refresh-token endpoint.

string

required

Unique idempotency key for the request to prevent duplicate processing.

string

required

The date and time at which the request was initiated (ISO 8601 format).

string

required

The IP address of the customer making the request.

string

required

Unique identifier for the interaction/session.

Path Parameters

string

required

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

Query Parameters

number

default:"1"

Page number for pagination (starts from 1).

number

default:"10"

Number of items per page (maximum recommended: 50).

Code Examples

curl --location 'https://{your-domain}.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'

const axios = require('axios');

const BASE_URL = 'https://{your-domain}.fincode.software/api/v1/services/user';

async function getCustomerLoanHistory(accessToken, customerId, page = 1, size = 10) {
  try {
    const response = await axios.get(
      `${BASE_URL}/loan-history/${customerId}`,
      {
        params: {
          page,
          size,
        },
        headers: {
          'X-Auth-Token': accessToken,
          'x-idempotency-key': `key-${Date.now()}`,
          'x-fapi-auth-date': new Date().toISOString(),
          'x-fapi-customer-ip-address': '192.168.1.1',
          'x-fapi-interaction-id': `interaction-${Date.now()}`,
        },
      }
    );

    loans.forEach((loan) => {
      console.log(
        `- ${loan.loanApplicationId}: ${loan.loanProductName} - ` +
        `${loan.loanAmount} (Status: ${loan.status})`
      );
    });

    return history;
  } catch (error) {
    console.error(
      'Failed to fetch customer loan history:',
      error.response?.data || error.message
    );
    throw error;
  }
}

Path Parameters

customerId

string

required

Query Parameters

page

integer

default:1

size

integer

default:10

Response

200

Loan history retrieved successfully

Getting Started

Core Flows

API Endpoints

Request Headers

Path Parameters

Query Parameters

Code Examples

Path Parameters

Query Parameters

Response

​Request Headers

​Path Parameters

​Query Parameters

​Code Examples

Path Parameters

Query Parameters

Response

Request Headers

Path Parameters

Query Parameters

Code Examples