List Accounts
curl --request GET \
--url https://{your-domain}.fincode.software/api/v6/services/account-maintenance/list-accounts/{account-owner-id} \
--header 'X-Auth-Token: <x-auth-token>' \
--header 'platform: <platform>' \
--header 'uuid: <uuid>' \
--header 'x-idempotency-key: <x-idempotency-key>'import requests
url = "https://{your-domain}.fincode.software/api/v6/services/account-maintenance/list-accounts/{account-owner-id}"
headers = {
"platform": "<platform>",
"uuid": "<uuid>",
"x-idempotency-key": "<x-idempotency-key>",
"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-idempotency-key': '<x-idempotency-key>',
'X-Auth-Token': '<x-auth-token>'
}
};
fetch('https://{your-domain}.fincode.software/api/v6/services/account-maintenance/list-accounts/{account-owner-id}', 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://{your-domain}.fincode.software/api/v6/services/account-maintenance/list-accounts/{account-owner-id}",
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>",
"x-idempotency-key: <x-idempotency-key>"
],
]);
$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://{your-domain}.fincode.software/api/v6/services/account-maintenance/list-accounts/{account-owner-id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("platform", "<platform>")
req.Header.Add("uuid", "<uuid>")
req.Header.Add("x-idempotency-key", "<x-idempotency-key>")
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://{your-domain}.fincode.software/api/v6/services/account-maintenance/list-accounts/{account-owner-id}")
.header("platform", "<platform>")
.header("uuid", "<uuid>")
.header("x-idempotency-key", "<x-idempotency-key>")
.header("X-Auth-Token", "<x-auth-token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://{your-domain}.fincode.software/api/v6/services/account-maintenance/list-accounts/{account-owner-id}")
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-idempotency-key"] = '<x-idempotency-key>'
request["X-Auth-Token"] = '<x-auth-token>'
response = http.request(request)
puts response.read_bodyAPI Endpoints
List Accounts
Retrieves a list of all accounts owned by a specific account owner (customer).
GET
/
account-maintenance
/
list-accounts
/
{account-owner-id}
List Accounts
curl --request GET \
--url https://{your-domain}.fincode.software/api/v6/services/account-maintenance/list-accounts/{account-owner-id} \
--header 'X-Auth-Token: <x-auth-token>' \
--header 'platform: <platform>' \
--header 'uuid: <uuid>' \
--header 'x-idempotency-key: <x-idempotency-key>'import requests
url = "https://{your-domain}.fincode.software/api/v6/services/account-maintenance/list-accounts/{account-owner-id}"
headers = {
"platform": "<platform>",
"uuid": "<uuid>",
"x-idempotency-key": "<x-idempotency-key>",
"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-idempotency-key': '<x-idempotency-key>',
'X-Auth-Token': '<x-auth-token>'
}
};
fetch('https://{your-domain}.fincode.software/api/v6/services/account-maintenance/list-accounts/{account-owner-id}', 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://{your-domain}.fincode.software/api/v6/services/account-maintenance/list-accounts/{account-owner-id}",
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>",
"x-idempotency-key: <x-idempotency-key>"
],
]);
$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://{your-domain}.fincode.software/api/v6/services/account-maintenance/list-accounts/{account-owner-id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("platform", "<platform>")
req.Header.Add("uuid", "<uuid>")
req.Header.Add("x-idempotency-key", "<x-idempotency-key>")
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://{your-domain}.fincode.software/api/v6/services/account-maintenance/list-accounts/{account-owner-id}")
.header("platform", "<platform>")
.header("uuid", "<uuid>")
.header("x-idempotency-key", "<x-idempotency-key>")
.header("X-Auth-Token", "<x-auth-token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://{your-domain}.fincode.software/api/v6/services/account-maintenance/list-accounts/{account-owner-id}")
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-idempotency-key"] = '<x-idempotency-key>'
request["X-Auth-Token"] = '<x-auth-token>'
response = http.request(request)
puts response.read_bodyFetches all accounts associated with a specific account owner, allowing customers to view all their accounts in one place.
Request Headers
Path Parameters
The unique identifier (UUID) of the account owner (customer) whose accounts to retrieve.
Code Examples
curl --location 'https://{domain}.fincode.software/api/v6/services/account-maintenance/list-accounts/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'
const axios = require('axios');
const BASE_URL = 'https://{domain}.fincode.software/api/v6/services/account-maintenance';
async function listAccounts(accessToken, accountOwnerId) {
try {
const response = await axios.get(
`${BASE_URL}/list-accounts/${accountOwnerId}`,
{
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()}`,
},
}
);
console.log(`Found ${response.data.data.length} accounts:`);
response.data.data.forEach((account) => {
console.log(
`${account.accountNumber}: ${account.accountName} ` +
`(${account.currencyCode}) - Balance: ${account.accountBalance}`
);
});
return response.data.data;
} catch (error) {
console.error(
'Failed to list accounts:',
error.response?.data || error.message
);
throw error;
}
}
