Ledger History
curl --request GET \
--url https://{tenant}.fincode.software/api/v6/services/ledger/account-ledger-history/{account_id}/{page}/{size} \
--header 'X-Auth-Token: <x-auth-token>' \
--header 'platform: <platform>' \
--header 'uuid: <uuid>'import requests
url = "https://{tenant}.fincode.software/api/v6/services/ledger/account-ledger-history/{account_id}/{page}/{size}"
headers = {
"platform": "<platform>",
"uuid": "<uuid>",
"X-Auth-Token": "<x-auth-token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {platform: '<platform>', uuid: '<uuid>', 'X-Auth-Token': '<x-auth-token>'}
};
fetch('https://{tenant}.fincode.software/api/v6/services/ledger/account-ledger-history/{account_id}/{page}/{size}', 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/v6/services/ledger/account-ledger-history/{account_id}/{page}/{size}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Auth-Token: <x-auth-token>",
"platform: <platform>",
"uuid: <uuid>"
],
]);
$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/v6/services/ledger/account-ledger-history/{account_id}/{page}/{size}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("platform", "<platform>")
req.Header.Add("uuid", "<uuid>")
req.Header.Add("X-Auth-Token", "<x-auth-token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://{tenant}.fincode.software/api/v6/services/ledger/account-ledger-history/{account_id}/{page}/{size}")
.header("platform", "<platform>")
.header("uuid", "<uuid>")
.header("X-Auth-Token", "<x-auth-token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://{tenant}.fincode.software/api/v6/services/ledger/account-ledger-history/{account_id}/{page}/{size}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["platform"] = '<platform>'
request["uuid"] = '<uuid>'
request["X-Auth-Token"] = '<x-auth-token>'
response = http.request(request)
puts response.read_bodyAPI Endpoints
Ledger History
Retrieves paginated transaction history for a specific account.
GET
/
ledger
/
account-ledger-history
/
{account_id}
/
{page}
/
{size}
Ledger History
curl --request GET \
--url https://{tenant}.fincode.software/api/v6/services/ledger/account-ledger-history/{account_id}/{page}/{size} \
--header 'X-Auth-Token: <x-auth-token>' \
--header 'platform: <platform>' \
--header 'uuid: <uuid>'import requests
url = "https://{tenant}.fincode.software/api/v6/services/ledger/account-ledger-history/{account_id}/{page}/{size}"
headers = {
"platform": "<platform>",
"uuid": "<uuid>",
"X-Auth-Token": "<x-auth-token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {platform: '<platform>', uuid: '<uuid>', 'X-Auth-Token': '<x-auth-token>'}
};
fetch('https://{tenant}.fincode.software/api/v6/services/ledger/account-ledger-history/{account_id}/{page}/{size}', 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/v6/services/ledger/account-ledger-history/{account_id}/{page}/{size}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Auth-Token: <x-auth-token>",
"platform: <platform>",
"uuid: <uuid>"
],
]);
$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/v6/services/ledger/account-ledger-history/{account_id}/{page}/{size}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("platform", "<platform>")
req.Header.Add("uuid", "<uuid>")
req.Header.Add("X-Auth-Token", "<x-auth-token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://{tenant}.fincode.software/api/v6/services/ledger/account-ledger-history/{account_id}/{page}/{size}")
.header("platform", "<platform>")
.header("uuid", "<uuid>")
.header("X-Auth-Token", "<x-auth-token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://{tenant}.fincode.software/api/v6/services/ledger/account-ledger-history/{account_id}/{page}/{size}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["platform"] = '<platform>'
request["uuid"] = '<uuid>'
request["X-Auth-Token"] = '<x-auth-token>'
response = http.request(request)
puts response.read_bodyFetches a paginated list of all ledger entries (transactions) for an account, providing a complete audit trail of account movements.
Request Headers
string
required
The JWT Access Token obtained from the
/login or /refresh-token endpoint.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 account to retrieve history for.
number
required
Page number for pagination (starts from 0 or 1, depending on implementation).
number
required
Number of items per page.
Code Examples
curl --location 'https://{domain}.fincode.software/api/v6/services/ledger/account-ledger-history/123e4567-e89b-12d3-a456-426614174000/0/10' \
--header 'X-Auth-Token: YOUR_JWT_ACCESS_TOKEN' \
--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://{domain}.fincode.software/api/v6/services/ledger';
async function getLedgerHistory(accessToken, accountId, page = 0, size = 10) {
try {
const response = await axios.get(
`${BASE_URL}/account-ledger-history/${accountId}/${page}/${size}`,
{
headers: {
'X-Auth-Token': accessToken,
'x-fapi-auth-date': new Date().toISOString(),
'x-fapi-customer-ip-address': '192.168.1.1',
'x-fapi-interaction-id': `interaction-${Date.now()}`,
},
}
);
console.log(`Found ${response.data.data.length} transactions:`);
response.data.data.forEach((entry) => {
console.log(
`${entry.executionDate}: ${entry.ledgerType} ` +
`${entry.transactionAmount} (Balance: ${entry.newBalance})`
);
});
return response.data.data;
} catch (error) {
console.error(
'Failed to fetch ledger history:',
error.response?.data || error.message
);
throw error;
}
}
⌘I