Moneybird logo
Moneybird API

Ledger accounts

Ledger accounts are the categories in your bookkeeping, like revenue, costs, assets, and liabilities.


Returns information about a ledger account

GET
https://moneybird.com/api/v2
/{administration_id}/ledger_accounts/{id}{format}

Returns information about a ledger account.

Required scope(s)

Any of: settings, sales_invoices, documents or estimates

Returns information about a ledger accountpath Parameters

administration_id
administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id
identifier · pattern: ^\d+$ · required

A unique record identifier

format
string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Returns information about a ledger account Responses

A ledger account

id
identifier · pattern: ^\d+$

A unique record identifier

administration_id
administration_id · pattern: ^\d+$

A unique record identifier

name
string
account_type
string · enum
Enum values:
non_current_assets
current_assets
equity
non_current_liabilities
current_liabilities
revenue
direct_costs
expenses
account_id
string | null
parent_id
identifier_nullable · pattern: ^\d+$

A unique record identifier

active
boolean
created_at
timestamp · date-time
updated_at
timestamp · date-time
allowed_document_types
string[]
Enum values:
sales_invoice
purchase_invoice
general_journal_document
financial_mutation
payment
taxonomy_item_response
financial_account_id
identifier_nullable · pattern: ^\d+$

A unique record identifier


Deletes a ledger account

DELETE
https://moneybird.com/api/v2
/{administration_id}/ledger_accounts/{id}{format}

Deletes or deactivates a ledger account. First, an attempt is made to deactivate the ledger account. If that fails, an attempt is made to delete the ledger account. Always returns a 204 status code even if the ledger account could not be deleted or deactivated.

Required scope(s)

settings

Deletes a ledger accountpath Parameters

administration_id
administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id
identifier · pattern: ^\d+$ · required

A unique record identifier

format
string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Deletes a ledger account Responses

Ledger account deleted

No data returned

Updates a ledger account

PATCH
https://moneybird.com/api/v2
/{administration_id}/ledger_accounts/{id}{format}

Updates a ledger account.

Required scope(s)

settings

Updates a ledger accountpath Parameters

administration_id
administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id
identifier · pattern: ^\d+$ · required

A unique record identifier

format
string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Updates a ledger account Request Body

object
rgs_code
string

Existing RGS version 3.5 code, e.g. 'WMfoBelMfo'

Updates a ledger account Responses

Ledger account updated

id
identifier · pattern: ^\d+$

A unique record identifier

administration_id
administration_id · pattern: ^\d+$

A unique record identifier

name
string
account_type
string · enum
Enum values:
non_current_assets
current_assets
equity
non_current_liabilities
current_liabilities
revenue
direct_costs
expenses
account_id
string | null
parent_id
identifier_nullable · pattern: ^\d+$

A unique record identifier

active
boolean
created_at
timestamp · date-time
updated_at
timestamp · date-time
allowed_document_types
string[]
Enum values:
sales_invoice
purchase_invoice
general_journal_document
financial_mutation
payment
taxonomy_item_response
financial_account_id
identifier_nullable · pattern: ^\d+$

A unique record identifier


List all ledger accounts of an administration

GET
https://moneybird.com/api/v2
/{administration_id}/ledger_accounts{format}

Returns a list of all the ledger accounts in the administration.

Pagination is not supported for this endpoint.

Required scope(s)

Any of: settings, sales_invoices, documents or estimates

List all ledger accounts of an administrationpath Parameters

administration_id
administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

format
string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

List all ledger accounts of an administration Responses

200

A list of ledger accounts

id
identifier · pattern: ^\d+$

A unique record identifier

administration_id
administration_id · pattern: ^\d+$

A unique record identifier

name
string
account_type
string · enum
Enum values:
non_current_assets
current_assets
equity
non_current_liabilities
current_liabilities
revenue
direct_costs
expenses
account_id
string | null
parent_id
identifier_nullable · pattern: ^\d+$

A unique record identifier

active
boolean
created_at
timestamp · date-time
updated_at
timestamp · date-time
allowed_document_types
string[]
Enum values:
sales_invoice
purchase_invoice
general_journal_document
financial_mutation
payment
taxonomy_item_response
financial_account_id
identifier_nullable · pattern: ^\d+$

A unique record identifier


Creates a new ledger account

POST
https://moneybird.com/api/v2
/{administration_id}/ledger_accounts{format}

The account_type determines the kind of ledger account, this can be any of the following values: non_current_assets, current_assets, equity, provisions, non_current_liabilities, current_liabilities, revenue, direct_costs, expenses, other_income_expenses

By providing the parent_id, it is possible to create a tree of ledger accounts. Make sure the account_types of the parent and child equal.

Required scope(s)

settings

Creates a new ledger accountpath Parameters

administration_id
administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

format
string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Creates a new ledger account Request Body

rgs_code
string · required

Existing RGS version 3.5 code, e.g. 'WMfoBelMfo'

object

Creates a new ledger account Responses

Ledger account created

id
identifier · pattern: ^\d+$

A unique record identifier

administration_id
administration_id · pattern: ^\d+$

A unique record identifier

name
string
account_type
string · enum
Enum values:
non_current_assets
current_assets
equity
non_current_liabilities
current_liabilities
revenue
direct_costs
expenses
account_id
string | null
parent_id
identifier_nullable · pattern: ^\d+$

A unique record identifier

active
boolean
created_at
timestamp · date-time
updated_at
timestamp · date-time
allowed_document_types
string[]
Enum values:
sales_invoice
purchase_invoice
general_journal_document
financial_mutation
payment
taxonomy_item_response
financial_account_id
identifier_nullable · pattern: ^\d+$

A unique record identifier