curl --request GET \
--url https://api.next.orenda.finance/v1/accounts \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.next.orenda.finance/v1/accounts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.next.orenda.finance/v1/accounts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"success": true,
"total": 1,
"page": 1,
"limit": 10,
"data": [
{
"accountId": "e4f5a6b7-3333-4d4e-8f5a-bbbbccccdddd",
"accountProviderAccountId": "ACC-558201",
"customerId": "c9f8e7d6-1111-4b2c-8d3e-444455556666",
"programId": "acmeclearbank",
"name": "Main EUR account",
"currency": "EUR",
"provider": "monavate",
"status": "ACTIVE",
"balance": 154200,
"availableBalance": 150000,
"availableBalanceUpdatedAt": "2026-06-29T09:14:00.000Z"
}
]
}Search accounts
Search customer accounts across providers.
CSV exports (resultType=file) enrich rows with onboarding fees.
Accounts in PENDING status are always excluded, regardless of any status filter you pass — this endpoint returns provisioned accounts only.
This endpoint does not accept keyword; use the specific identifier filters below.
All filters accept comma-separated values for multi-select.
curl --request GET \
--url https://api.next.orenda.finance/v1/accounts \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.next.orenda.finance/v1/accounts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.next.orenda.finance/v1/accounts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"success": true,
"total": 1,
"page": 1,
"limit": 10,
"data": [
{
"accountId": "e4f5a6b7-3333-4d4e-8f5a-bbbbccccdddd",
"accountProviderAccountId": "ACC-558201",
"customerId": "c9f8e7d6-1111-4b2c-8d3e-444455556666",
"programId": "acmeclearbank",
"name": "Main EUR account",
"currency": "EUR",
"provider": "monavate",
"status": "ACTIVE",
"balance": 154200,
"availableBalance": 150000,
"availableBalanceUpdatedAt": "2026-06-29T09:14:00.000Z"
}
]
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
The program to scope results to. Required on every request — including when you pass allPrograms=true. A request without it is rejected before it reaches the search.
When true, widen the search from the single programId to every program your operator role is entitled to. It never reaches beyond your entitlements, and it does not remove the need to send programId. A role with no program entitlement matches nothing rather than everything.
true, false Filter by customer ID. Comma-separated for multi-select.
Filter by custodian ID. Comma-separated for multi-select. Ignored for guardian-bound roles, which are always scoped to their own guardian.
Filter by status. Comma-separated for multi-select.
Lower bound (inclusive) on record date, ISO 8601.
Upper bound (inclusive) on record date, ISO 8601.
1-based page number. Defaults to 1.
x >= 1Maximum number of items per page.
x >= 1Field to sort results by.
Sort direction.
asc, desc Result format. json (default) returns inline results; file returns a presigned S3 CSV URL (valid 1 hour) in place of the data array.
json, file Customises the filename of the exported CSV when resultType=file.
Filter by Orenda account ID. Comma-separated for multi-select.
Filter by the provider's own account identifier. Comma-separated for multi-select.
Filter by account name. Comma-separated for multi-select.
Filter by account type. Comma-separated for multi-select.
Filter by IBAN. Comma-separated for multi-select.
Filter by account number. Comma-separated for multi-select.
Filter by sort code. Comma-separated for multi-select.
Filter by account provider. Comma-separated for multi-select.
Filter by currency (ISO 4217), e.g. EUR, GBP. Comma-separated for multi-select.
Filter by exact creation timestamp. Comma-separated for multi-select. For ranges use fromDate / toDate.
Response
Matching accounts, or a presigned export URL when resultType=file.
- Option 1
- Option 2
Inline JSON results, or — when resultType=file — a presigned CSV export URL.