GET
/
v1
/
customers
/
{customerId}
/
accounts
List accounts
curl --request GET \
  --url https://api.next.orenda.finance/v1/customers/{customerId}/accounts \
  --header 'Authorization: Bearer <token>'
import requests

url = "https://api.next.orenda.finance/v1/customers/{customerId}/accounts"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.next.orenda.finance/v1/customers/{customerId}/accounts', 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://api.next.orenda.finance/v1/customers/{customerId}/accounts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);

$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://api.next.orenda.finance/v1/customers/{customerId}/accounts"

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

req.Header.Add("Authorization", "Bearer <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://api.next.orenda.finance/v1/customers/{customerId}/accounts")
.header("Authorization", "Bearer <token>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.next.orenda.finance/v1/customers/{customerId}/accounts")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
{
  "success": true,
  "data": [
    {
      "accountId": "acc_7c1d8e4a",
      "name": "Ada Lovelace",
      "currency": "GBP",
      "balance": "1250.00",
      "availableBalance": "1180.00",
      "status": "Active",
      "accountType": "Current",
      "accountNumber": "87654321",
      "sortCode": "040506",
      "bic": "NWBKGB2L",
      "bankName": "Orenda Bank",
      "virtualIbans": [
        "GB29NWBK60161331926819"
      ],
      "balances": [
        {
          "currency": "GBP",
          "balance": "1250.00"
        }
      ],
      "limits": {
        "accountSingle": 5000,
        "accountDaily": 10000,
        "accountMonthly": 50000,
        "usedDaily": 320,
        "usedMonthly": 8750,
        "maximumSingle": 10000,
        "maximumDaily": 25000,
        "maximumMonthly": 100000
      }
    },
    {
      "accountId": "acc_9b2e5f7d",
      "name": "Ada Lovelace",
      "currency": "EUR",
      "balance": "640.00",
      "availableBalance": "640.00",
      "status": "Active",
      "accountType": "Current",
      "iban": "DE89370400440532013000",
      "bic": "ORNDDEFF",
      "bankName": "Orenda Bank",
      "virtualIbans": [],
      "balances": [
        {
          "currency": "EUR",
          "balance": "640.00"
        }
      ]
    }
  ],
  "total": 2,
  "page": 1,
  "limit": 10
}
{
"success": false,
"code": "<string>",
"message": "<string>"
}
Returns the customer’s accounts. This is usually the first call after sign-in — the accountId of each account is what you pass to cards, payments, and beneficiary endpoints. Accounts that are still being created (pending) don’t appear; they show up once provisioning completes.
Use availableBalance for “can they spend it now” displays, and balance for the ledger total.

Authorizations

Authorization
string
header
required

The user's access token.

Path Parameters

customerId
string
required

The customer's ID.

Query Parameters

accountId
string

Filter by account ID(s), comma-separated.

currency
string

Filter by currency code(s), e.g. GBP,EUR.

status
string

Filter by status, e.g. Active.

page
integer
default:1
limit
integer
default:10

Items per page.

sortBy
string
default:created
sortOrder
enum<string>
default:desc
Available options:
asc,
desc

Response

Accounts

success
boolean
Example:

true

data
object[]
total
integer
Example:

2

page
integer
Example:

1

limit
integer
Example:

10