Refresh a bank connection
curl --request POST \
--url https://app.sahlfinancial.com/api/v1/partner/bank-connections/{connection_id}/refresh \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.sahlfinancial.com/api/v1/partner/bank-connections/{connection_id}/refresh', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.sahlfinancial.com/api/v1/partner/bank-connections/{connection_id}/refresh"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text){
"id": "c1a4e2d7-93b5-4f08-8a6d-2e7b1f9c3d54",
"tenant_id": "0b6f5a3e-7c1d-4e0a-9d2f-3a1c5e8b7f10",
"case_id": "7e3b9a14-2d6c-4c85-b1f0-6a8d4e2c9b37",
"bank_code": "attijariwafa",
"bank_name": "Attijariwafa bank",
"account_holder": "Test Client",
"account_last4": "4821",
"status": "connected",
"link_token": "Zk3x...redacted",
"connected_at": "2026-10-07T09:14:22Z",
"expires_at": "2027-01-05T09:14:22Z",
"avg_balance": 21450,
"monthly_income": 18200,
"monthly_expenses": 11800,
"transaction_count": 96,
"cash_flow_data": null,
"environment": "sandbox",
"created_at": "2026-10-07T09:14:22Z",
"updated_at": "2026-10-07T09:14:22Z"
}{
"detail": "Can only refresh connected accounts"
}{
"detail": "<string>"
}{
"detail": {
"code": "bank_scope_not_allowed",
"message": "This workspace is not enabled for the partner bank API."
}
}{
"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."
}Refresh a bank connection
Required scope: bank:write.
Growth plan. Switched on per workspace by Sahl: until then a key cannot be issued with this scope and calls answer 403 bank_scope_not_allowed. No bank data provider is live: data is a sandbox simulation (send X-Sahl-Environment: sandbox), and in production create, refresh, transactions and analysis answer 409 bank_connect_unavailable.
Sandbox only today. Only a connected account can be refreshed (400 otherwise). In production: 409 bank_connect_unavailable.
Refresh a bank connection
curl --request POST \
--url https://app.sahlfinancial.com/api/v1/partner/bank-connections/{connection_id}/refresh \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.sahlfinancial.com/api/v1/partner/bank-connections/{connection_id}/refresh', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.sahlfinancial.com/api/v1/partner/bank-connections/{connection_id}/refresh"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text){
"id": "c1a4e2d7-93b5-4f08-8a6d-2e7b1f9c3d54",
"tenant_id": "0b6f5a3e-7c1d-4e0a-9d2f-3a1c5e8b7f10",
"case_id": "7e3b9a14-2d6c-4c85-b1f0-6a8d4e2c9b37",
"bank_code": "attijariwafa",
"bank_name": "Attijariwafa bank",
"account_holder": "Test Client",
"account_last4": "4821",
"status": "connected",
"link_token": "Zk3x...redacted",
"connected_at": "2026-10-07T09:14:22Z",
"expires_at": "2027-01-05T09:14:22Z",
"avg_balance": 21450,
"monthly_income": 18200,
"monthly_expenses": 11800,
"transaction_count": 96,
"cash_flow_data": null,
"environment": "sandbox",
"created_at": "2026-10-07T09:14:22Z",
"updated_at": "2026-10-07T09:14:22Z"
}{
"detail": "Can only refresh connected accounts"
}{
"detail": "<string>"
}{
"detail": {
"code": "bank_scope_not_allowed",
"message": "This workspace is not enabled for the partner bank API."
}
}{
"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
API key created in the console. Scopes: kyc:extract, kyc:verify, kyc:eid; bank:read, bank:write (Growth plan, enabled per workspace by Sahl).
Headers
Path Parameters
Query Parameters
Response
OK