Skip to main content

List Nominal Codes (Dropdown)

GET 

/api/nominal-codes/list

Returns a lightweight list of all nominal codes (id, code, name, type), ordered by code. Intended for dropdown/combo-box lookups.

Every nominal code record is returned independently — no deduplication. Integration re-syncs (e.g. QuickBooks Online) can legitimately create multiple rows sharing the same code + name; each appears as its own entry with its own id.

Pass used_by_transactions=1 to restrict the list to nominal codes referenced by at least one accounting transaction line — used by the Accounting Transactions filter dropdown so unused codes don't appear as dead filter options.

Archived nominal codes are excluded automatically.

The type field is the account type (Revenue, Expense, Asset, Liability, Equity, Bank, Current) and can be used for client-side filtering (e.g. asset-only dropdowns).

Authentication: Requires Bearer token.

Request

Responses

Successful response