Get account details

GET https://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

id string required
Prefixed account ID (e.g. acc_1200).

Response

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

Error codes

400 Invalid ID format.
404 Account not found.