List the transactions of a bank connection
curl --request GET \
--url https://app.sahlfinancial.com/api/v1/bank-connections/{connection_id}/transactions \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.sahlfinancial.com/api/v1/bank-connections/{connection_id}/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.sahlfinancial.com/api/v1/bank-connections/{connection_id}/transactions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"id": "txn-2026-09-salary",
"date": "2026-09-25",
"description": "VIREMENT SALAIRE OCP GROUP",
"amount": 18120.5,
"type": "credit",
"category": "salary",
"balance": 31240.75
},
{
"id": "txn-2026-09-000",
"date": "2026-09-03",
"description": "VIREMENT LOYER",
"amount": -4310,
"type": "debit",
"category": "rent",
"balance": 13120.25
}
],
"total": 2,
"account_holder": "Test Client",
"bank_name": "Attijariwafa bank"
}{
"detail": "Invalid or expired token"
}{
"detail": "Insufficient permissions"
}{
"detail": "Bank connection not found"
}{
"detail": {
"code": "bank_connect_unavailable",
"message": "Bank connection is not available yet. No bank data provider is live for this workspace."
}
}{
"detail": [
{
"type": "missing",
"loc": [
"body",
"bank_code"
],
"msg": "Field required",
"input": {}
}
]
}{
"code": "rate_limit_exceeded",
"message": "Too many requests. Please slow down."
}List the transactions of a bank connection
Who can call it: Any signed-in member of the workspace.
Six months of generated transactions, newest first, amounts in MAD. Not paginated.
Production behaviour. No open-banking provider is live. This route answers 409 with the code bank_connect_unavailable unless the request is made in the Sandbox: send X-Sahl-Environment: sandbox (or ?environment=sandbox). In the Sandbox the data is simulated and derived from the connection id; it is not read from a bank. A request with no environment is also refused.
Auth: dashboard session (Authorization: Bearer <access token>). Not available with a partner API key.
List the transactions of a bank connection
curl --request GET \
--url https://app.sahlfinancial.com/api/v1/bank-connections/{connection_id}/transactions \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.sahlfinancial.com/api/v1/bank-connections/{connection_id}/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.sahlfinancial.com/api/v1/bank-connections/{connection_id}/transactions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"id": "txn-2026-09-salary",
"date": "2026-09-25",
"description": "VIREMENT SALAIRE OCP GROUP",
"amount": 18120.5,
"type": "credit",
"category": "salary",
"balance": 31240.75
},
{
"id": "txn-2026-09-000",
"date": "2026-09-03",
"description": "VIREMENT LOYER",
"amount": -4310,
"type": "debit",
"category": "rent",
"balance": 13120.25
}
],
"total": 2,
"account_holder": "Test Client",
"bank_name": "Attijariwafa bank"
}{
"detail": "Invalid or expired token"
}{
"detail": "Insufficient permissions"
}{
"detail": "Bank connection not found"
}{
"detail": {
"code": "bank_connect_unavailable",
"message": "Bank connection is not available yet. No bank data provider is live for this workspace."
}
}{
"detail": [
{
"type": "missing",
"loc": [
"body",
"bank_code"
],
"msg": "Field required",
"input": {}
}
]
}{
"code": "rate_limit_exceeded",
"message": "Too many requests. Please slow down."
}Authorizations
The access token (JWT) of a signed-in console user, from POST /v1/auth/login. It lasts 30 minutes. It is not an API key: a partner API key is refused here. There is no cookie.