Get account details

GEThttps://app.speybooks.com/api/v1/accounts/{id}

Retrieves a single account by prefixed ID, including all fields: code, name, type, hierarchy position, VAT defaults, system flags, and timestamps.

Path parameters

idstringrequired
Prefixed account ID (e.g. acc_1200).

Response

200Returns the account details including all fields, hierarchy position, VAT defaults, and system flags.
Show response fields
accountTypestring
Account type. Determines balance direction and report section. Immutable on system accounts.
assetliabilityequityrevenueexpense
codestring
Unique account code within the organisation (e.g. 1200, 4000). Max 20 characters.
controlTypestringnullable
Control account category (e.g. trade_debtors, trade_creditors, vat_control). Only meaningful when isControlAccount is true.
createdAtstringdate-time
ISO 8601 creation timestamp.
defaultVatRateintegernullable
Default VAT rate as a whole percentage (e.g. 20 for 20%). Applied as suggestion when creating transaction lines.
descriptionstringnullable
Optional description of the account purpose. Max 500 characters.
idstring
Prefixed account ID (e.g. acc_1200). Immutable after creation.
isActiveboolean
Whether the account is active. Inactive accounts are excluded from selection lists but retained for historical reporting.
isControlAccountboolean
Whether this is a control account used in automated journal creation (e.g. Trade Debtors for invoice finalisation).
isSystemboolean
Whether the account was seeded during organisation setup. System accounts cannot be modified (except isActive) or deleted. Read-only.
namestring
Display name (e.g. Trade Debtors, Sales). Max 200 characters.
parentIdstringnullable
Prefixed ID of the parent account (e.g. acc_100), or null for root accounts.
updatedAtstringdate-time
ISO 8601 last-updated timestamp.

Error codes

400Invalid ID format.
404Account not found.