Skip to main content
GET
/
v1
/
platform
/
businesses
/
{business_id}
/
general-ledger
/
chart-of-accounts
/
{account_id}
Get account detail
curl --request GET \
  --url https://sandbox.thredfi.com/v1/platform/businesses/{business_id}/general-ledger/chart-of-accounts/{account_id}/ \
  --header 'Authorization: Bearer <token>'
{
  "id": "acc-1000-uuid",
  "code": "1000",
  "name": "Bank - Barclays Current",
  "currency": "GBP",
  "account_type": "asset",
  "account_type_display": "Asset",
  "account_subtype": "current_assets",
  "account_subtype_display": "Current Assets",
  "parent_account_code": null,
  "current_balance": 1250050,
  "current_balance_formatted": "£12,500.50",
  "debit_balance": 1500000,
  "credit_balance": 249950,
  "period_balance": null,
  "period_balance_formatted": null,
  "has_children": false,
  "hierarchy_level": 0,
  "is_active": true,
  "description": "Primary business current account with Barclays",
  "institution_name": "Barclays Bank PLC",
  "iban": "GB29BUKB20201555555555",
  "sort_code": "20-20-15",
  "account_number_mask": "****5555",
  "total_debits": 234,
  "total_credits": 189,
  "last_entry_date": "2024-03-28T14:30:00Z",
  "last_entry_reference": "JE-2024-0042",
  "sub_accounts": []
}

Authorizations

Authorization
string
header
required

Partner-level JWT token (unscoped). Token payload includes partner_id. Business access is validated via partner ownership. Format: Bearer <your-jwt-token>

Use this for: Multi-business operations where the business_id is specified in the URL and partner has access to multiple businesses.

Path Parameters

account_id
string
required

Account UUID, code, or external_id

business_id
string<uuid>
required

Business UUID

Response

Detailed serializer for account with additional information.

id
string<uuid>
required

Unique account identifier

code
string
required

Account code from chart of accounts (e.g., '1000', '4000')

name
string
required

Account name from chart of accounts

currency
string
required

Account currency from business base currency (GBP, EUR, USD)

account_type
enum<string>
required

Account type code (asset, liability, equity, revenue, expense)

  • asset - Asset
  • liability - Liability
  • equity - Equity
  • revenue - Revenue
  • expense - Expense
Available options:
asset,
liability,
equity,
revenue,
expense
account_type_display
string | null
required

Human-readable account type (e.g., 'Current Asset', 'Revenue')

account_subtype
enum<string>
required

Account subtype code for more granular classification (bank, cash, etc.)

  • current_assets - Current Assets
  • non_current_assets - Non-current Assets
  • current_liabilities - Current Liabilities
  • non_current_liabilities - Non-current Liabilities
  • share_capital - Share Capital
  • share_premium - Share Premium
  • reserves - Reserves
  • retained_earnings - Retained Earnings
  • revenue - Revenue
  • other_operating_income - Other Operating Income
  • finance_income - Finance Income
  • direct_costs - Direct Costs
  • operating_expenses - Operating Expenses
  • finance_costs - Finance Costs
  • income_tax - Income Tax
Available options:
current_assets,
non_current_assets,
current_liabilities,
non_current_liabilities,
share_capital,
share_premium,
reserves,
retained_earnings,
revenue,
other_operating_income,
finance_income,
direct_costs,
operating_expenses,
finance_costs,
income_tax
account_subtype_display
string | null
required

Account subtype for more granular classification

parent_account_code
string | null
required

Parent account code if this is a sub-account (null for top-level accounts)

current_balance
integer
required

Current balance in cents

current_balance_formatted
string
required

Formatted balance with currency symbol (e.g., '£12,500.50')

debit_balance
integer
required

Debit balance in cents

credit_balance
integer
required

Credit balance in cents

period_balance
integer
required

Period balance in cents (null if no period filter applied)

period_balance_formatted
string | null
required

Formatted period balance with currency symbol (null if no period filter)

has_children
boolean
required

Whether this account has sub-accounts (nested hierarchy)

hierarchy_level
integer
required

Depth in account hierarchy (0 for root accounts)

is_active
boolean
required

Whether this account is active and accepting transactions

description
string
required

Detailed account description

institution_name
string | null
required

Bank institution name (for bank accounts only)

iban
string | null
required

International Bank Account Number (for bank accounts)

sort_code
string | null
required

UK bank sort code (for UK bank accounts, format: XX-XX-XX)

account_number_mask
string | null
required

Masked account number showing last 4 digits (e.g., '****5555')

total_debits
integer
required

Total number of debit transactions (count, not amount)

total_credits
integer
required

Total number of credit transactions (count, not amount)

last_entry_date
string<date-time> | null
required

Date of most recent journal entry

last_entry_reference
string
required

Reference of most recent journal entry

sub_accounts
object[]
required

List of sub-accounts if this is a parent account (empty array if no children)