Get a bank connection
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
id*stringGetbeel-Company?stringAct on one of the account's client companies (its id from GET /companies) instead of the key's own account. 404 company_not_found when the key cannot act on it.
uuidOK
application/json- response
object*stringid*string^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidprovider*stringapplication_id*stringYour Enable Banking application id (the key is never returned).
bank*|nullpsu_type*string"business""personal"status*stringpending: the bank login was not completed yet. active: synced every 6 hours. requires_reconnect: the consent expired or was revoked; reconnect (POST /bank-connections/{id}/reconnect or the app).
"pending""active""requires_reconnect"consent_expires_at*|nullexpires_soon*booleanThe consent ends within 7 days: reconnect (POST /bank-connections/{id}/reconnect or the app).
last_synced_at*|nulllast_error*string|nullaccounts*array<>created_at*string^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$date-timecurl -X GET 'https://www.getbeel.com/api/v1/bank-connections/string'{ "object": "bank_connection", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "provider": "enable_banking", "application_id": "string", "bank": { "name": "Intesa Sanpaolo", "country": "IT" }, "psu_type": "business", "status": "pending", "consent_expires_at": "2019-08-24T14:15:22Z", "expires_soon": true, "last_synced_at": "2019-08-24T14:15:22Z", "last_error": "string", "accounts": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "iban": "string", "name": "string", "currency": "string", "active": true, "balance": { "amount": "122.00", "currency": "string" }, "last_synced_at": "2019-08-24T14:15:22Z", "last_booking_date": "2026-10-29", "transactions": -9007199254740991, "pending_transactions": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "date": "2026-10-29", "description": "string", "counterparty_name": "string", "amount": "122.00", "currency": "string", "type": "debit" } ] } ], "created_at": "2019-08-24T14:15:22Z"}Connect a bank POST
Checks the Enable Banking application (a real call with your key), saves it and starts the bank login. Open authorization_url in a browser: a getbeel page names your team, the user continues to the bank, logs in and lands in the getbeel app, and the first sync (last 90 days) starts right away. Add getbeel's redirect URL (https://getbeel.com/api/open-banking/callback) to your application's allowed redirect URLs first. Pay as you go: €2.00 per connected bank account per month and €0.02 per imported movement, from the prepaid balance (402 insufficient_balance when it does not cover them). Each team uses its own Enable Banking application (application id + RSA private key from the Enable Banking control panel); getbeel stores the key encrypted and never returns it. Live keys only (403 livemode_required with a test key): bank and connection data is real, there is no sandbox for it.
Disconnect a bank DELETE
Closes the consent at the bank and deletes the stored key. Synced statements, transactions and matches stay. Live keys only (403 livemode_required with a test key): bank and connection data is real, there is no sandbox for it.