curl --request GET \
--url https://sandbox.thredfi.com/v1/platform/businesses/{business_id}/bank-accounts/{bank_account_id}/ \
--header 'Authorization: Bearer <token>'import requests
url = "https://sandbox.thredfi.com/v1/platform/businesses/{business_id}/bank-accounts/{bank_account_id}/"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://sandbox.thredfi.com/v1/platform/businesses/{business_id}/bank-accounts/{bank_account_id}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox.thredfi.com/v1/platform/businesses/{business_id}/bank-accounts/{bank_account_id}/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://sandbox.thredfi.com/v1/platform/businesses/{business_id}/bank-accounts/{bank_account_id}/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://sandbox.thredfi.com/v1/platform/businesses/{business_id}/bank-accounts/{bank_account_id}/")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.thredfi.com/v1/platform/businesses/{business_id}/bank-accounts/{bank_account_id}/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "9f90c3cc-6i00-0h16-eeee-eii81402618g",
"account_key": "plaid_acc_Barclays_Checking_1234",
"display_name": "Barclays Business Current Account",
"official_name": "Barclays Bank PLC - Business Account",
"mask": "1234",
"balance": 12500.5,
"balance_cents": 1250050,
"currency": "GBP",
"is_active": true,
"bank_link_status": "active",
"bank_link_id": "8e80c3cc-5h99-9g05-dddd-dhh70291507f",
"business_id": "7d70c3cc-4g88-8f04-cccc-cgg69180406e",
"business_name": "The Red Lion Pub Ltd",
"provider": "plaid",
"mapped_account": "acc-1000-cash",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-03-28T14:22:00Z"
}{
"error_code": "<string>",
"message": "<string>",
"detail": {},
"request_id": "<string>"
}{
"error_code": "<string>",
"message": "<string>",
"detail": {},
"request_id": "<string>"
}{
"error_code": "<string>",
"message": "<string>",
"detail": {},
"request_id": "<string>"
}{
"error_code": "<string>",
"message": "<string>",
"detail": {},
"request_id": "<string>"
}{
"error_code": "<string>",
"message": "<string>",
"detail": {},
"request_id": "<string>"
}{
"error_code": "<string>",
"message": "<string>",
"detail": {},
"request_id": "<string>"
}{
"error_code": "<string>",
"message": "<string>",
"detail": {},
"request_id": "<string>"
}Retrieve Bank Account Connection
Retrieve detailed information about a specific bank account connection.
Returns comprehensive information including:
- Account details (name, mask, balance, currency)
- Connection status and sync information
- Bank link context (provider, business)
- Account mapping information
- Timestamps and metadata
Access Control:
- Only accessible for bank accounts belonging to the authenticated partner’s businesses
curl --request GET \
--url https://sandbox.thredfi.com/v1/platform/businesses/{business_id}/bank-accounts/{bank_account_id}/ \
--header 'Authorization: Bearer <token>'import requests
url = "https://sandbox.thredfi.com/v1/platform/businesses/{business_id}/bank-accounts/{bank_account_id}/"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://sandbox.thredfi.com/v1/platform/businesses/{business_id}/bank-accounts/{bank_account_id}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://sandbox.thredfi.com/v1/platform/businesses/{business_id}/bank-accounts/{bank_account_id}/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://sandbox.thredfi.com/v1/platform/businesses/{business_id}/bank-accounts/{bank_account_id}/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://sandbox.thredfi.com/v1/platform/businesses/{business_id}/bank-accounts/{bank_account_id}/")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox.thredfi.com/v1/platform/businesses/{business_id}/bank-accounts/{bank_account_id}/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "9f90c3cc-6i00-0h16-eeee-eii81402618g",
"account_key": "plaid_acc_Barclays_Checking_1234",
"display_name": "Barclays Business Current Account",
"official_name": "Barclays Bank PLC - Business Account",
"mask": "1234",
"balance": 12500.5,
"balance_cents": 1250050,
"currency": "GBP",
"is_active": true,
"bank_link_status": "active",
"bank_link_id": "8e80c3cc-5h99-9g05-dddd-dhh70291507f",
"business_id": "7d70c3cc-4g88-8f04-cccc-cgg69180406e",
"business_name": "The Red Lion Pub Ltd",
"provider": "plaid",
"mapped_account": "acc-1000-cash",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-03-28T14:22:00Z"
}{
"error_code": "<string>",
"message": "<string>",
"detail": {},
"request_id": "<string>"
}{
"error_code": "<string>",
"message": "<string>",
"detail": {},
"request_id": "<string>"
}{
"error_code": "<string>",
"message": "<string>",
"detail": {},
"request_id": "<string>"
}{
"error_code": "<string>",
"message": "<string>",
"detail": {},
"request_id": "<string>"
}{
"error_code": "<string>",
"message": "<string>",
"detail": {},
"request_id": "<string>"
}{
"error_code": "<string>",
"message": "<string>",
"detail": {},
"request_id": "<string>"
}{
"error_code": "<string>",
"message": "<string>",
"detail": {},
"request_id": "<string>"
}Authorizations
Business-scoped JWT token. Token payload includes business_id to automatically scope requests. Format: Bearer <your-jwt-token>
Use this for: Business-specific operations where the business context is embedded in the token.
Response
Comprehensive serializer for bank account connections.
Provides detailed information about connected bank accounts including status, balance, sync information, and related business context.
Unique bank account connection identifier
Provider-specific account key for identifying this account in their system
255Current account balance in decimal format (e.g., 12500.50 for £12,500.50) - for backward compatibility
Current account balance in cents (e.g., 1250050 for £12,500.50)
Bank link connection status (active, revoked, error)
Bank link UUID that this account belongs to
Business UUID that owns this bank account
Business name for display purposes
Banking data provider (e.g., plaid, open_banking)
Timestamp when bank account was first connected
Timestamp of last update to account information
User-friendly account name (e.g., 'Business Current Account')
255Official bank account name from the financial institution
255Last 4 digits of account number for identification (e.g., '1234')
10Account currency code (GBP, EUR, USD)
3Whether this account connection is active and syncing transactions (false if disconnected)
Chart of accounts ID this bank account is mapped to (null if not mapped)
Was this page helpful?