Moneybird logo
Moneybird API

Ledger accounts

Endpoint:https://moneybird.com/api/v2

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.

Returns information about a ledger accountpath Parameters

  • administration_idstring | integer · pattern: ^\d+$ · required

    The unique identifier of the administration

    A unique record identifier of an administration

  • idstring | integer · pattern: ^\d+$ · required

    A unique record identifier

  • formatstring · 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 accountResponses

A ledger account

  • idstring | integer · pattern: ^\d+$

    A unique record identifier

  • administration_idstring | integer · pattern: ^\d+$

    A unique record identifier of an administration

  • namestring
  • account_typestring · enum
    Enum values:
    non_current_assets
    current_assets
    equity
    non_current_liabilities
    current_liabilities
    revenue
    direct_costs
    expenses
  • account_idstring | null
  • parent_idstring | integer | null · pattern: ^\d+$

    A unique record identifier

  • created_atstring · date-time
  • updated_atstring · date-time
  • allowed_document_typesstring[]
    Enum values:
    sales_invoice
    purchase_invoice
    general_journal_document
    financial_mutation
    payment
  • taxonomy_itemobject
  • financial_account_idstring | integer | null · 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.

Deletes a ledger accountpath Parameters

  • administration_idstring | integer · pattern: ^\d+$ · required

    The unique identifier of the administration

    A unique record identifier of an administration

  • idstring | integer · pattern: ^\d+$ · required

    A unique record identifier

  • formatstring · 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 accountResponses

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.

Updates a ledger accountpath Parameters

  • administration_idstring | integer · pattern: ^\d+$ · required

    The unique identifier of the administration

    A unique record identifier of an administration

  • idstring | integer · pattern: ^\d+$ · required

    A unique record identifier

  • formatstring · 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 accountRequest Body

  • ledger_accountobject
  • rgs_codestring

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

Updates a ledger accountResponses

Ledger account updated

  • idstring | integer · pattern: ^\d+$

    A unique record identifier

  • administration_idstring | integer · pattern: ^\d+$

    A unique record identifier of an administration

  • namestring
  • account_typestring · enum
    Enum values:
    non_current_assets
    current_assets
    equity
    non_current_liabilities
    current_liabilities
    revenue
    direct_costs
    expenses
  • account_idstring | null
  • parent_idstring | integer | null · pattern: ^\d+$

    A unique record identifier

  • created_atstring · date-time
  • updated_atstring · date-time
  • allowed_document_typesstring[]
    Enum values:
    sales_invoice
    purchase_invoice
    general_journal_document
    financial_mutation
    payment
  • taxonomy_itemobject
  • financial_account_idstring | integer | null · 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.

List all ledger accounts of an administrationpath Parameters

  • administration_idstring | integer · pattern: ^\d+$ · required

    The unique identifier of the administration

    A unique record identifier of an administration

  • formatstring · 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 administrationResponses

A list of ledger accounts

  • idstring | integer · pattern: ^\d+$

    A unique record identifier

  • administration_idstring | integer · pattern: ^\d+$

    A unique record identifier of an administration

  • namestring
  • account_typestring · enum
    Enum values:
    non_current_assets
    current_assets
    equity
    non_current_liabilities
    current_liabilities
    revenue
    direct_costs
    expenses
  • account_idstring | null
  • parent_idstring | integer | null · pattern: ^\d+$

    A unique record identifier

  • created_atstring · date-time
  • updated_atstring · date-time
  • allowed_document_typesstring[]
    Enum values:
    sales_invoice
    purchase_invoice
    general_journal_document
    financial_mutation
    payment
  • taxonomy_itemobject
  • financial_account_idstring | integer | null · 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.

Creates a new ledger accountpath Parameters

  • administration_idstring | integer · pattern: ^\d+$ · required

    The unique identifier of the administration

    A unique record identifier of an administration

  • formatstring · 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 accountRequest Body

  • rgs_codestring · required

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

  • ledger_accountobject

Creates a new ledger accountResponses

Ledger account created

  • idstring | integer · pattern: ^\d+$

    A unique record identifier

  • administration_idstring | integer · pattern: ^\d+$

    A unique record identifier of an administration

  • namestring
  • account_typestring · enum
    Enum values:
    non_current_assets
    current_assets
    equity
    non_current_liabilities
    current_liabilities
    revenue
    direct_costs
    expenses
  • account_idstring | null
  • parent_idstring | integer | null · pattern: ^\d+$

    A unique record identifier

  • created_atstring · date-time
  • updated_atstring · date-time
  • allowed_document_typesstring[]
    Enum values:
    sales_invoice
    purchase_invoice
    general_journal_document
    financial_mutation
    payment
  • taxonomy_itemobject
  • financial_account_idstring | integer | null · pattern: ^\d+$

    A unique record identifier