List Accounts

curl --request GET \
  --url https://{tenant}.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://{tenant}.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://{tenant}.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://{tenant}.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://{tenant}.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://{tenant}.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://{tenant}.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_body

GET

account-maintenance

list-accounts

{account-owner-id}

List Accounts

curl --request GET \
  --url https://{tenant}.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://{tenant}.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://{tenant}.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://{tenant}.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://{tenant}.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://{tenant}.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://{tenant}.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_body

Fetches all accounts associated with a specific account owner, allowing customers to view all their accounts in one place.

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

account-owner-id

string

required

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;
  }
}

Headers

platform

string

default:fincode

required

uuid

string

default:200

required

x-idempotency-key

string

required

X-Auth-Token

string

required

Path Parameters

account-owner-id

string

required

Response

200

List of accounts

Ledger History by Idempotency Key Change Account Permission

Getting Started

Core Flows

API Endpoints

List Accounts

Request Headers

Path Parameters

Code Examples

Headers

Path Parameters

Response

​Request Headers

​Path Parameters

​Code Examples

Headers

Path Parameters

Response

Request Headers

Path Parameters

Code Examples