Accounts

A list of the categories used by a business to record and classify accounting transactions.

Overview

Accounts are the categories a business uses to record and classify accounting transactions. From the Accounts endpoint, you can retrieve a list of all accounts for a specified business. See Chart of Accounts endpoint for more details.

Railz normalizes all chart of accounts using 4 subclassifications:

  • Section - the highest level classification of an account, e.g. Asset, Liability, Income, etc.
  • Subsection - a more granular classification of an account based on the Section, e.g. Current assets, Current Liabilities, etc.
  • Group - a more granular classification of an account based on Subsection, e.g. Cash, Inventory, Depreciation, etc.
  • Sub-group - the most granular classification of an account representing an individual account and is based on Group, e.g. Cash on Hand, Accumulated Amortization, etc.

Data Model

👍

Filtering Bank Accounts

Use the isBankAccount to filter the business' accounts to show only bank accounts.

Field

Type

Description

id

string

Identifier for the account, unique for the business.

nominalCode

string

Reference given to each nominal account for a business. It ensures money is allocated to the correct account.

name
sortable, filterable

string

Name of the account as specified by the business.

fullyQualifiedName
sortable, filterable

string

Fully qualified name of the object; derived from name and parent account as generated by the accounting service provider.

description

string

Description of the account as specified by the business.

section
sortable, filterable

string

Railz normalized account classification.

subSection
sortable, filterable

string

Railz normalized account classification.

group
sortable, filterable

string

Railz normalized account classification.

supGroup
sortable, filterable

string

Railz normalized account classification.

classification
sortable, filterable

string

The original classification of an account from the accounting service provider, e.g. Asset.

type
sortable, filterable

string

The original type of an account from the accounting service provider, e.g. Fixed Asset.

subtype
sortable, filterable

string

The original subtype of an account from the accounting service provider, e.g. Furniture And Fixtures

currencyRef

Reference Types

Currency of the account.

currentBalance
sortable, filterable

decimal

Current balance in the account.

isBankAccount
sortable, filterable

boolean

Confirms whether the account is a bank account or not.

isSubAccount
sortable, filterable

boolean

Confirms whether the account is a sub account or not.

isActive
sortable, filterable

boolean

Confirms whether the account is an active account or not.

sourceModifiedDate
sortable, filterable

string
See Date

Date the record was last changed in the accounting service provider.

Account Reference

Data types that reference an account, for example, bill and invoice line items, use an accountRef that includes the id and name of the linked account.

📘

Using Account Reference in Push

For convenience, when pushing data accountRef can be used alone with the id as a value instead of nesting it within.

When pushing to Xero, use nomincalCode as a value.

Example Data

{
  "data":
  [
    {
      "id": "1",
      "nominalCode": "200",
      "name": "Bank Account",
      "fullyQualifiedName": "ABC Financial Checking",
      "description": "Account description.",
      "section": "Asset",
      "subSection": "Current Assets",
      "group": "Cash and Cash Equivalents",
      "subGroup": "Cash on Hand",
      "classification": "Asset",
      "type": "Bank",
      "subType": "CashOnHand",
      "currencyRef":
      {
        "id": "CAD",
        "name": "Canadian Dollar"
      },
      "currentBalance": 10000,
      "isBankAccount": true,
      "isSubAccount": true,
      "isActive": true,
      "sourceModifiedDate": "2021-03-09T10:18:29.985Z"
    }
  ]
}

Did this page help you?