curl --request GET \
--url https://api.next.orenda.finance/v1/transactions \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.next.orenda.finance/v1/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.next.orenda.finance/v1/transactions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"success": true,
"total": 1,
"page": 1,
"limit": 10,
"data": [
{
"transactionId": "f5a6b7c8-4444-4e5f-9a6b-ccccddddeeee",
"accountId": "e4f5a6b7-3333-4d4e-8f5a-bbbbccccdddd",
"customerId": "c9f8e7d6-1111-4b2c-8d3e-444455556666",
"direction": "OUT",
"amount": 2599,
"currency": "EUR",
"status": "COMPLETED",
"isFee": false,
"merchantName": "Zalando",
"merchantCountry": "DE",
"createdDateTime": "2026-06-01T11:20:03.000Z"
}
]
}Search transactions
Search ledger transactions.
Merges prepaid-master-account and crypto transactions where applicable. accountId accepts provider account IDs. Use reportFormat to select an alternate CSV column layout on export.
All filters accept comma-separated values for multi-select.
curl --request GET \
--url https://api.next.orenda.finance/v1/transactions \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.next.orenda.finance/v1/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.next.orenda.finance/v1/transactions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"success": true,
"total": 1,
"page": 1,
"limit": 10,
"data": [
{
"transactionId": "f5a6b7c8-4444-4e5f-9a6b-ccccddddeeee",
"accountId": "e4f5a6b7-3333-4d4e-8f5a-bbbbccccdddd",
"customerId": "c9f8e7d6-1111-4b2c-8d3e-444455556666",
"direction": "OUT",
"amount": 2599,
"currency": "EUR",
"status": "COMPLETED",
"isFee": false,
"merchantName": "Zalando",
"merchantCountry": "DE",
"createdDateTime": "2026-06-01T11:20:03.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.
Free-text search across indexed fields.
1-based page number. Defaults to 1.
x >= 1Maximum number of items per page.
x >= 1Field to sort results by.
Sort direction.
asc, desc Filter by status. Comma-separated for multi-select.
Lower bound (inclusive) on record date, ISO 8601.
Upper bound (inclusive) on record date, ISO 8601.
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 transaction ID. Comma-separated for multi-select.
Filter by currency (ISO 4217). Comma-separated for multi-select.
Filter by payment type, e.g. PAYIN, PAYOUT. Comma-separated for multi-select.
Filter by payment sub-type (scheme), e.g. PI_SEPA_INST. Comma-separated for multi-select.
Filter by provider. Comma-separated for multi-select.
Exclude transactions from the given providers. Comma-separated for multi-select.
Filter by the provider's end-to-end reference. Comma-separated for multi-select.
Filter by the customer-supplied reference. Comma-separated for multi-select.
Filter by unique reference. Comma-separated for multi-select.
Filter by internal reference. Comma-separated for multi-select.
Filter by payee name. Comma-separated for multi-select.
Filter by payer name. Comma-separated for multi-select.
Filter by exact transaction timestamp. Comma-separated for multi-select. For ranges use fromDate / toDate.
Filter by account ID (provider account IDs are also accepted). Comma-separated for multi-select.
Filter by payment ID. Comma-separated for multi-select.
Filter by transaction direction (e.g. IN, OUT). Comma-separated for multi-select.
When true, returns only fee transactions; when false, excludes them.
true, false Filter by card ID. Comma-separated for multi-select.
Filter by merchant ID. Comma-separated for multi-select.
Filter by merchant name. Comma-separated for multi-select.
Filter by merchant country. Comma-separated for multi-select.
Selects an alternate CSV column layout for resultType=file exports.
Response
Matching transactions, or a presigned export URL when resultType=file.
- Option 1
- Option 2
Inline JSON results, or — when resultType=file — a presigned CSV export URL.