Reports

Reports provide analytical data about your administration, such as revenue and expense breakdowns by various dimensions like projects, contacts, or time periods.

Assets report

GET

https://moneybird.com/api/v2

/{administration_id}/reports/assets{format}

Get the assets report for the administration.

Required scope(s)

documents

Assets report › path 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

Assets report › query Parameters

period

string · pattern: ^\d{6,8}(..\d{6,8})?…

The period can be a date range or one of the presets. Date ranges must consist of whole months (start on 1st, end on last day of month).

Date range formats:

YYYYMMDD..YYYYMMDD (e.g., 20250101..20250131)
YYYYMM..YYYYMM (e.g., 202501..202501)
YYYYMM (e.g., 202501)

Preset options:

this_month - Current month (default if not specified)
prev_month - Previous month
next_month - Next month
this_quarter - Current quarter
prev_quarter - Previous quarter
next_quarter - Next quarter
this_year - Current year
prev_year - Previous year
next_year - Next year

Maximum period: 12 months.

Default: this_month

Assets report › Responses

An assets report

object[]

asset_id

identifier · pattern: ^\d+$

A unique record identifier

ledger_account_id

identifier · pattern: ^\d+$

A unique record identifier

name

string

purchase_date

string · date

lifespan

string | null

In seconds

purchase_value

string

calculated_purchase_value

string

residual_value

string

total_value_changes_since_purchase

string

value_at_begin

string

investment

string

depreciation

string

divestment

string

value_changes

string

value_at_end

string

value_not_in_use

string

Amount booked on an asset whose purchase date is after the end of the period

GET/{administration_id}/reports/assets{format}

curl https://moneybird.com/api/v2/:administration_id/reports/assets:format \
  --header 'Authorization: Bearer <token>'

Example Responses

[
  {
    "asset_id": "501695615198037353",
    "ledger_account_id": "501695615176017256",
    "name": "Test Asset",
    "purchase_date": "2025-01-01",
    "lifespan": "157784760",
    "purchase_value": "12345.67",
    "calculated_purchase_value": "12345.67",
    "residual_value": "10.0",
    "total_value_changes_since_purchase": "-200.0",
    "value_at_begin": "12145.67",
    "investment": "0",
    "depreciation": "0.0",
    "divestment": "0.0",
    "value_changes": "0.0",
    "value_at_end": "12145.67",
    "value_not_in_use": "0"
  }
]

json

application/json

Balance sheet report

GET

https://moneybird.com/api/v2

/{administration_id}/reports/balance_sheet{format}

Get the balance sheet report for the administration showing the financial position at the end of the specified period.

With granularity, periods also gives the balance sheet at the end of every month, quarter or year in the period.

Required scope(s)

bank

Balance sheet report › path 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

Balance sheet report › query Parameters

period

string · pattern: ^\d{6,8}(..\d{6,8})?…

The period can be a date range or one of the presets. Date ranges must consist of whole months (start on 1st, end on last day of month).

Date range formats:

YYYYMMDD..YYYYMMDD (e.g., 20250101..20250131)
YYYYMM..YYYYMM (e.g., 202501..202501)
YYYYMM (e.g., 202501)

Preset options:

this_month - Current month (default if not specified)
prev_month - Previous month
next_month - Next month
this_quarter - Current quarter
prev_quarter - Previous quarter
next_quarter - Next quarter
this_year - Current year
prev_year - Previous year
next_year - Next year

Maximum period: 12 months.

Default: this_month

granularity

string · enum

Splits the report into periods of a month, a quarter or a year. The response then also contains periods, with the same fields for each period. The first and the last period are cut off at the start and the end of period.

Enum values:

month

quarter

year

Balance sheet report › Responses

A balance sheet report

balance_sheet_debit

Debit side of the balance sheet (assets)

balance_sheet_credit

Credit side of the balance sheet (equity and liabilities)

object[]

Only present when granularity is given. One item for each month, quarter or year in period, oldest first.

GET/{administration_id}/reports/balance_sheet{format}

curl https://moneybird.com/api/v2/:administration_id/reports/balance_sheet:format \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "debit": {
    "total": "1150.0",
    "current_assets": [
      {
        "ledger_account_id": "501695629027705893",
        "value": "850.0",
        "children": [
          {
            "ledger_account_id": "501695629057066026",
            "value": "100.0"
          }
        ]
      }
    ],
    "non_current_assets": [
      {
        "ledger_account_id": "501695629063357487",
        "value": "200.0",
        "children": []
      }
    ]
  },
  "credit": {
    "total": "1150.0",
    "equity": [
      {
        "ledger_account_id": "501695629081183294",
        "value": "600.0",
        "children": []
      }
    ],
    "provisions": [
      {
        "ledger_account_id": "501695629074891833",
        "value": "150.0",
        "children": []
      }
    ],
    "non_current_liabilities": [],
    "current_liabilities": [
      {
        "ledger_account_id": "501695629069648948",
        "value": "300.0",
        "children": []
      }
    ],
    "open_years": [
      {
        "year": "2024",
        "value": "100.0"
      }
    ]
  },
  "periods": [
    {
      "period": "202505..202505",
      "debit": {
        "total": "50.0",
        "current_assets": [
          {
            "ledger_account_id": "501695629027705893",
            "value": "50.0",
            "children": []
          }
        ],
        "non_current_assets": []
      },
      "credit": {
        "total": "150.0",
        "equity": [
          {
            "ledger_account_id": "501695629081183294",
            "value": "50.0",
            "children": []
          }
        ],
        "provisions": [],
        "non_current_liabilities": [],
        "current_liabilities": [],
        "open_years": [
          {
            "year": "2024",
            "value": "100.0"
          }
        ]
      }
    },
    {
      "period": "202506..202506",
      "debit": {
        "total": "1150.0",
        "current_assets": [
          {
            "ledger_account_id": "501695629027705893",
            "value": "850.0",
            "children": [
              {
                "ledger_account_id": "501695629057066026",
                "value": "100.0"
              }
            ]
          }
        ],
        "non_current_assets": [
          {
            "ledger_account_id": "501695629063357487",
            "value": "200.0",
            "children": []
          }
        ]
      },
      "credit": {
        "total": "1150.0",
        "equity": [
          {
            "ledger_account_id": "501695629081183294",
            "value": "600.0",
            "children": []
          }
        ],
        "provisions": [
          {
            "ledger_account_id": "501695629074891833",
            "value": "150.0",
            "children": []
          }
        ],
        "non_current_liabilities": [],
        "current_liabilities": [
          {
            "ledger_account_id": "501695629069648948",
            "value": "300.0",
            "children": []
          }
        ],
        "open_years": [
          {
            "year": "2024",
            "value": "100.0"
          }
        ]
      }
    }
  ]
}

json

application/json

Bank balance report

GET

https://moneybird.com/api/v2

/{administration_id}/reports/bank_balance{format}

Get the booked balance of each financial account at the end of the specified period. These are the balances in the bookkeeping, not the balances the bank reports.

With granularity, periods also gives the balances at the end of every month, quarter or year in the period.

Required scope(s)

bank

Bank balance report › path 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

Bank balance report › query Parameters

period

string · pattern: ^\d{6,8}(..\d{6,8})?…

The period can be a date range or one of the presets. Date ranges must consist of whole months (start on 1st, end on last day of month).

Date range formats:

YYYYMMDD..YYYYMMDD (e.g., 20250101..20250131)
YYYYMM..YYYYMM (e.g., 202501..202501)
YYYYMM (e.g., 202501)

Preset options:

this_month - Current month (default if not specified)
prev_month - Previous month
next_month - Next month
this_quarter - Current quarter
prev_quarter - Previous quarter
next_quarter - Next quarter
this_year - Current year
prev_year - Previous year
next_year - Next year

Maximum period: 12 months.

Default: this_month

granularity

string · enum

Enum values:

month

quarter

year

Bank balance report › Responses

A bank balance report

total

string

The total of financial_accounts, the same as closing_balance of the cash flow report

object[]

The booked balance of every financial account except private withdrawal accounts. Like the balance sheet, an account with a zero balance in every period is left out.

object[]

Only present when granularity is given. One item for each month, quarter or year in period, oldest first.

Cash flow report

GET

https://moneybird.com/api/v2

/{administration_id}/reports/cash_flow{format}

Get the cash flow report for the administration showing cash received and cash paid during the specified period.

The fields at the top level always cover the whole period: opening_balance is the balance at its start and closing_balance the balance at its end. With granularity, periods gives the same fields per month, quarter or year. Within a period, a section only lists the ledger accounts with cash received or paid in that period.

Required scope(s)

bank

Cash flow report › path 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

Cash flow report › query Parameters

period

string · pattern: ^\d{6,8}(..\d{6,8})?…

The period can be a date range or one of the presets. Date ranges must consist of whole months (start on 1st, end on last day of month).

Date range formats:

YYYYMMDD..YYYYMMDD (e.g., 20250101..20250131)
YYYYMM..YYYYMM (e.g., 202501..202501)
YYYYMM (e.g., 202501)

Preset options:

this_month - Current month (default if not specified)
prev_month - Previous month
next_month - Next month
this_quarter - Current quarter
prev_quarter - Previous quarter
next_quarter - Next quarter
this_year - Current year
prev_year - Previous year
next_year - Next year

Maximum period: 12 months.

Default: this_month

granularity

string · enum

Enum values:

month

quarter

year

financial_account_id

identifier · pattern: ^\d+$

Filter the cash flow report by a specific financial account

A unique record identifier

Cash flow report › Responses

A cash flow report

ledger_account_data

Data grouped by ledger account. Contains an array of ledger account entries with ledger_account_id and value.

ledger_account_data

Data grouped by ledger account. Contains an array of ledger account entries with ledger_account_id and value.

opening_balance

string

The balance of the financial accounts at the start of the period

closing_balance

string

The balance of the financial accounts at the end of the period

object[]

Only present when granularity is given. One item for each month, quarter or year in period, oldest first.

GET/{administration_id}/reports/cash_flow{format}

curl https://moneybird.com/api/v2/:administration_id/reports/cash_flow:format \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "cash_received_by_ledger_account": {
    "ledger_accounts": [
      {
        "ledger_account_id": "501695709303539530",
        "value": "130.0"
      }
    ]
  },
  "cash_paid_by_ledger_account": {
    "ledger_accounts": [
      {
        "ledger_account_id": "501695709311928147",
        "value": "-50.0"
      }
    ]
  },
  "opening_balance": "0",
  "closing_balance": "80.0",
  "periods": [
    {
      "period": "202505..202505",
      "cash_received_by_ledger_account": {
        "ledger_accounts": [
          {
            "ledger_account_id": "501695709303539530",
            "value": "30.0"
          }
        ]
      },
      "cash_paid_by_ledger_account": {
        "ledger_accounts": []
      },
      "opening_balance": "0.0",
      "closing_balance": "30.0"
    },
    {
      "period": "202506..202506",
      "cash_received_by_ledger_account": {
        "ledger_accounts": [
          {
            "ledger_account_id": "501695709303539530",
            "value": "100.0"
          }
        ]
      },
      "cash_paid_by_ledger_account": {
        "ledger_accounts": [
          {
            "ledger_account_id": "501695709311928147",
            "value": "-50.0"
          }
        ]
      },
      "opening_balance": "30.0",
      "closing_balance": "80.0"
    }
  ]
}

json

application/json

Creditors report

GET

https://moneybird.com/api/v2

/{administration_id}/reports/creditors{format}

Returns the balance of each creditor at the end of the specified period. The start of the period does not change the result.

With granularity, periods also gives the balance of each creditor at the end of every month, quarter or year in the period.

Required scope(s)

documents

Creditors report › path 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

Creditors report › query Parameters

period

string · pattern: ^\d{6,8}(..\d{6,8})?…

The period can be a date range or one of the presets. Date ranges must consist of whole months (start on 1st, end on last day of month).

Date range formats:

YYYYMMDD..YYYYMMDD (e.g., 20250101..20250131)
YYYYMM..YYYYMM (e.g., 202501..202501)
YYYYMM (e.g., 202501)

Preset options:

this_month - Current month (default if not specified)
prev_month - Previous month
next_month - Next month
this_quarter - Current quarter
prev_quarter - Previous quarter
next_quarter - Next quarter
this_year - Current year
prev_year - Previous year
next_year - Next year

Maximum period: 12 months.

Default: this_month

granularity

string · enum

Enum values:

month

quarter

year

page

integer | string

per_page

integer | string · min: 1 · max: 100 · pattern: ^\d+$

Creditors report › Responses

Successful response

creditors_report_item[]

object[]

Only present when granularity is given. One item for each month, quarter or year in period, oldest first.

Creditors aging report

GET

https://moneybird.com/api/v2

/{administration_id}/reports/creditors_aging{format}

Returns a creditors aging report for the specified administration.

Required scope(s)

documents

Creditors aging report › path 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

Creditors aging report › query Parameters

period_until

string · pattern: ^\d{6,8}|this_month|…

A period until which a report should be generated.

Date range formats:

YYYYMM (e.g., 202501)

Preset options:

this_month - Current month (default if not specified)
prev_month - Previous month
this_quarter - Current quarter
prev_quarter - Previous quarter
this_year - Current year
prev_year - Previous year

Default: this_month

page

integer | string

per_page

integer | string · min: 1 · max: 100 · pattern: ^\d+$

Creditors aging report › Responses

Successful response

aging_report_item[]

GET/{administration_id}/reports/creditors_aging{format}

curl https://moneybird.com/api/v2/:administration_id/reports/creditors_aging:format \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "creditors": [
    {
      "contact_id": "501695644347401437",
      "amount": "600.0",
      "aging_buckets": [
        {
          "name": "0 - 30 dagen",
          "amount": "100.0"
        },
        {
          "name": "30 - 60 dagen",
          "amount": "200.0"
        },
        {
          "name": "Ouder",
          "amount": "300.0"
        },
        {
          "name": "Totaal",
          "amount": "600.0"
        }
      ]
    },
    {
      "contact_id": "501695644363130091",
      "amount": "150.0",
      "aging_buckets": [
        {
          "name": "0 - 30 dagen",
          "amount": "150.0"
        },
        {
          "name": "30 - 60 dagen",
          "amount": "0"
        },
        {
          "name": "Ouder",
          "amount": "0.0"
        },
        {
          "name": "Totaal",
          "amount": "150.0"
        }
      ]
    }
  ]
}

json

application/json

Debtors report

GET

https://moneybird.com/api/v2

/{administration_id}/reports/debtors{format}

Returns the balance of each debtor at the end of the specified period. The start of the period does not change the result.

With granularity, periods also gives the balance of each debtor at the end of every month, quarter or year in the period.

Required scope(s)

sales_invoices

Debtors report › path 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

Debtors report › query Parameters

period

string · pattern: ^\d{6,8}(..\d{6,8})?…

The period can be a date range or one of the presets. Date ranges must consist of whole months (start on 1st, end on last day of month).

Date range formats:

YYYYMMDD..YYYYMMDD (e.g., 20250101..20250131)
YYYYMM..YYYYMM (e.g., 202501..202501)
YYYYMM (e.g., 202501)

Preset options:

this_month - Current month (default if not specified)
prev_month - Previous month
next_month - Next month
this_quarter - Current quarter
prev_quarter - Previous quarter
next_quarter - Next quarter
this_year - Current year
prev_year - Previous year
next_year - Next year

Maximum period: 12 months.

Default: this_month

granularity

string · enum

Enum values:

month

quarter

year

page

integer | string

per_page

integer | string · min: 1 · max: 100 · pattern: ^\d+$

Debtors report › Responses

Successful response

debtors_report_item[]

object[]

Only present when granularity is given. One item for each month, quarter or year in period, oldest first.

Debtors aging report

GET

https://moneybird.com/api/v2

/{administration_id}/reports/debtors_aging{format}

Returns a debtors aging report for the specified administration.

Required scope(s)

sales_invoices

Debtors aging report › path 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

Debtors aging report › query Parameters

period_until

string · pattern: ^\d{6,8}|this_month|…

A period until which a report should be generated.

Date range formats:

YYYYMM (e.g., 202501)

Preset options:

this_month - Current month (default if not specified)
prev_month - Previous month
this_quarter - Current quarter
prev_quarter - Previous quarter
this_year - Current year
prev_year - Previous year

Default: this_month

page

integer | string

per_page

integer | string · min: 1 · max: 100 · pattern: ^\d+$

Debtors aging report › Responses

Successful response

aging_report_item[]

GET/{administration_id}/reports/debtors_aging{format}

curl https://moneybird.com/api/v2/:administration_id/reports/debtors_aging:format \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "debtors": [
    {
      "contact_id": "501695676732671778",
      "amount": "600.0",
      "aging_buckets": [
        {
          "name": "0 - 30 dagen",
          "amount": "100.0"
        },
        {
          "name": "30 - 60 dagen",
          "amount": "200.0"
        },
        {
          "name": "Ouder",
          "amount": "300.0"
        },
        {
          "name": "Totaal",
          "amount": "600.0"
        }
      ]
    },
    {
      "contact_id": "501695676745254704",
      "amount": "150.0",
      "aging_buckets": [
        {
          "name": "0 - 30 dagen",
          "amount": "150.0"
        },
        {
          "name": "30 - 60 dagen",
          "amount": "0"
        },
        {
          "name": "Ouder",
          "amount": "0.0"
        },
        {
          "name": "Totaal",
          "amount": "150.0"
        }
      ]
    }
  ]
}

json

application/json

Expenses by contact report

GET

https://moneybird.com/api/v2

/{administration_id}/reports/expenses_by_contact{format}

Returns a expenses by contact report for the specified administration.

With granularity, periods splits the amounts per month, quarter or year. Within a period, only the contacts on this page with bookings in that period are listed.

Required scope(s)

documents

Expenses by contact report › path 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

Expenses by contact report › query Parameters

period

string · pattern: ^\d{6,8}(..\d{6,8})?…

The period can be a date range or one of the presets. Date ranges must consist of whole months (start on 1st, end on last day of month).

Date range formats:

YYYYMMDD..YYYYMMDD (e.g., 20250101..20250131)
YYYYMM..YYYYMM (e.g., 202501..202501)
YYYYMM (e.g., 202501)

Preset options:

this_month - Current month (default if not specified)
prev_month - Previous month
next_month - Next month
this_quarter - Current quarter
prev_quarter - Previous quarter
next_quarter - Next quarter
this_year - Current year
prev_year - Previous year
next_year - Next year

Maximum period: 12 months.

Default: this_month

granularity

string · enum

Enum values:

month

quarter

year

page

integer | string

per_page

integer | string · min: 1 · max: 100 · pattern: ^\d+$

Expenses by contact report › Responses

Successful response

contact_report_item[]

object[]

Only present when granularity is given. One item for each month, quarter or year in period, oldest first.

Expenses by project report

GET

https://moneybird.com/api/v2

/{administration_id}/reports/expenses_by_project{format}

Returns a expenses by project report for the specified administration.

With granularity, periods splits the amounts per month, quarter or year. Within a period, only the projects on this page with bookings in that period are listed.

Required scope(s)

documents

Expenses by project report › path 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

Expenses by project report › query Parameters

period

string · pattern: ^\d{6,8}(..\d{6,8})?…

The period can be a date range or one of the presets. Date ranges must consist of whole months (start on 1st, end on last day of month).

Date range formats:

YYYYMMDD..YYYYMMDD (e.g., 20250101..20250131)
YYYYMM..YYYYMM (e.g., 202501..202501)
YYYYMM (e.g., 202501)

Preset options:

this_month - Current month (default if not specified)
prev_month - Previous month
next_month - Next month
this_quarter - Current quarter
prev_quarter - Previous quarter
next_quarter - Next quarter
this_year - Current year
prev_year - Previous year
next_year - Next year

Maximum period: 12 months.

Default: this_month

granularity

string · enum

Enum values:

month

quarter

year

page

integer | string

per_page

integer | string · min: 1 · max: 100 · pattern: ^\d+$

Expenses by project report › Responses

Successful response

project_report_item[]

object[]

Only present when granularity is given. One item for each month, quarter or year in period, oldest first.

Export auditfile

POST

https://moneybird.com/api/v2

/{administration_id}/reports/export/auditfile{format}

Queue the export of an auditfile (XAF XML format) for the specified year. The auditfile will be added to your downloads when ready.

The administration must not have any ledger accounts with missing or duplicate account IDs, and the specified year must contain journal entries.

Required scope(s)

All of: bank, documents, estimates, sales_invoices and settings

Export auditfile › path 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

Export auditfile › Request Body

year

string · required

The year for which to generate the auditfile

version

string · enum

The XAF version of the auditfile

Enum values:

3.2

4.0

Default: 3.2

Export auditfile › Responses

No content

No data returned

Export brugstaat

POST

https://moneybird.com/api/v2

/{administration_id}/reports/export/brugstaat{format}

Queue the export of a brugstaat XML file for the specified year. The file will be added to your downloads when ready.

All ledger accounts must have valid RGS taxonomy codes assigned.

Required scope(s)

All of: bank, documents and sales_invoices

Export brugstaat › path 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

Export brugstaat › Request Body

year

string · required

The year for which to generate the brugstaat

Export brugstaat › Responses

No content

No data returned

Export ledger accounts

POST

https://moneybird.com/api/v2

/{administration_id}/reports/export/ledger_accounts{format}

Queue the export of ledger accounts (grootboekkaarten) to an Excel file for the specified year. This file contains all bookings and can be used for manual audits. The file will be added to your downloads when ready.

The specified year must contain journal entries.

Required scope(s)

documents and sales_invoices

Export ledger accounts › path 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

Export ledger accounts › Request Body

year

string · required

The year for which to generate the ledger accounts

Export ledger accounts › Responses

No content

No data returned

General ledger report

GET

https://moneybird.com/api/v2

/{administration_id}/reports/general_ledger{format}

Get the general ledger report for the administration showing all ledger accounts with their balances and movements during the specified period.

With granularity, periods gives the same report for every month, quarter or year in the period: the debit and credit sums of that period, and the balance at its start and end. Within a period, only the ledger accounts with a balance or bookings are listed. Profit and loss accounts start at zero in every period, so their final_balance in a period is the result of that period alone; balance sheet accounts carry their balance over. The debit and credit sums leave out the bookings of a fiscal year ending, but the start balance of the next period includes them, so a period does not always start at the final_balance of the period before it.

Required scope(s)

bank

General ledger report › path 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

General ledger report › query Parameters

period

string · pattern: ^\d{6,8}(..\d{6,8})?…

The period can be a date range or one of the presets. Date ranges must consist of whole months (start on 1st, end on last day of month).

Date range formats:

YYYYMMDD..YYYYMMDD (e.g., 20250101..20250131)
YYYYMM..YYYYMM (e.g., 202501..202501)
YYYYMM (e.g., 202501)

Preset options:

this_month - Current month (default if not specified)
prev_month - Previous month
next_month - Next month
this_quarter - Current quarter
prev_quarter - Previous quarter
next_quarter - Next quarter
this_year - Current year
prev_year - Previous year
next_year - Next year

Maximum period: 12 months.

Default: this_month

granularity

string · enum

Enum values:

month

quarter

year

General ledger report › Responses

A general ledger report

ledger_account_data

Data grouped by ledger account. Contains an array of ledger account entries with ledger_account_id and value.

ledger_account_data

Data grouped by ledger account. Contains an array of ledger account entries with ledger_account_id and value.

ledger_account_data

Data grouped by ledger account. Contains an array of ledger account entries with ledger_account_id and value.

ledger_account_data

Data grouped by ledger account. Contains an array of ledger account entries with ledger_account_id and value.

object[]

Only present when granularity is given. One item for each month, quarter or year in period, oldest first.

GET/{administration_id}/reports/general_ledger{format}

curl https://moneybird.com/api/v2/:administration_id/reports/general_ledger:format \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "debit_sums": {
    "ledger_accounts": [
      {
        "ledger_account_id": "501695661100500722",
        "value": "1000.0"
      }
    ]
  },
  "credit_sums": {
    "ledger_accounts": [
      {
        "ledger_account_id": "501695661100500722",
        "value": "500.0"
      }
    ]
  },
  "start_balance": {
    "ledger_accounts": [
      {
        "ledger_account_id": "501695661100500722",
        "value": "300.0"
      }
    ]
  },
  "final_balance": {
    "ledger_accounts": [
      {
        "ledger_account_id": "501695661100500722",
        "value": "800.0"
      }
    ]
  }
}

json

application/json

Journal entries report

GET

https://moneybird.com/api/v2

/{administration_id}/reports/journal_entries{format}

Get the journal entries report showing all bookings within the specified period. This endpoint allows filtering by various criteria including project, contact, ledger account, and account types.

Requirements:

At least one of project_id, contact_id, or ledger_account_id is required
When account_type is provided, either contact_id or project_id must also be specified

Example Use Cases:

To get a report for revenue by project detail, use account_type parameter with value "revenue" and the required project_id
To get a report for revenue by contact detail, use account_type parameter with value "revenue" and the required contact_id
To get a report for expenses by project detail, make one request for account_type "expenses" and one for "direct_costs", both with the required project_id
To get a report for expenses by contact detail, make one request for account_type "expenses" and one for "direct_costs", both with the required contact_id

Required scope(s)

documents and sales_invoices

Journal entries report › path 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

Journal entries report › query Parameters

period

string · pattern: ^\d{6,8}(..\d{6,8})?…

The period can be a date range or one of the presets. Date ranges must consist of whole months (start on 1st, end on last day of month).

Date range formats:

YYYYMMDD..YYYYMMDD (e.g., 20250101..20250131)
YYYYMM..YYYYMM (e.g., 202501..202501)
YYYYMM (e.g., 202501)

Preset options:

this_month - Current month (default if not specified)
prev_month - Previous month
next_month - Next month
this_quarter - Current quarter
prev_quarter - Previous quarter
next_quarter - Next quarter
this_year - Current year
prev_year - Previous year
next_year - Next year

Maximum period: 12 months.

Default: this_month

page

integer | string

per_page

integer | string · min: 1 · max: 100 · pattern: ^\d+$

project_id

string

Filter by project ID, use "null" to filter entries without project

contact_id

string

Filter by contact ID, use "null" to filter entries without contact

ledger_account_id

identifier · pattern: ^\d+$

Filter by ledger account ID

A unique record identifier

account_type

string · enum

Filter by ledger account type

Enum values:

non_current_assets

current_assets

equity

non_current_liabilities

current_liabilities

revenue

direct_costs

expenses

Journal entries report › Responses

A paginated list of journal entries (bookings)

object[]

id

string

Unique identifier for the journal entry

administration_id

identifier · pattern: ^\d+$

ID of the administration this entry belongs to

date

string · date

Date of the journal entry

document_type

string

Type of document this entry relates to

document_id

identifier · pattern: ^\d+$

ID of the related document

ledger_account_id

identifier · pattern: ^\d+$

ID of the ledger account

project_id

identifier_nullable · pattern: ^\d+$

ID of the related project, if any

contact_id

identifier_nullable · pattern: ^\d+$

ID of the related contact, if any

tax_rate_id

identifier_nullable · pattern: ^\d+$

ID of the applied tax rate, if any

financial_account_id

identifier_nullable · pattern: ^\d+$

ID of the financial account, if any

amount

string

Amount of the journal entry in the administration's currency

description

string

Description of the journal entry

GET/{administration_id}/reports/journal_entries{format}

curl https://moneybird.com/api/v2/:administration_id/reports/journal_entries:format \
  --header 'Authorization: Bearer <token>'

Example Responses

[
  {
    "id": "je_6",
    "date": "2025-06-14",
    "document_type": "Document",
    "document_id": "501695640639636490",
    "ledger_account_id": "123",
    "project_id": null,
    "contact_id": null,
    "tax_rate_id": null,
    "financial_account_id": null,
    "amount": "500.0",
    "description": "Large customer payment"
  },
  {
    "id": "je_5",
    "date": "2025-06-12",
    "document_type": "Document",
    "document_id": "501695640636490758",
    "ledger_account_id": "123",
    "project_id": null,
    "contact_id": null,
    "tax_rate_id": null,
    "financial_account_id": null,
    "amount": "-75.0",
    "description": "Credit note"
  },
  {
    "id": "je_3",
    "date": "2025-06-10",
    "document_type": "Document",
    "document_id": "501695640629151742",
    "ledger_account_id": "123",
    "project_id": null,
    "contact_id": null,
    "tax_rate_id": null,
    "financial_account_id": null,
    "amount": "250.0",
    "description": "Product sales"
  },
  {
    "id": "je_4",
    "date": "2025-06-08",
    "document_type": "Document",
    "document_id": "501695640632296450",
    "ledger_account_id": "123",
    "project_id": null,
    "contact_id": null,
    "tax_rate_id": null,
    "financial_account_id": null,
    "amount": "-25.0",
    "description": "Sales return"
  },
  {
    "id": "je_2",
    "date": "2025-06-05",
    "document_type": "Document",
    "document_id": "501695640626006010",
    "ledger_account_id": "123",
    "project_id": null,
    "contact_id": null,
    "tax_rate_id": null,
    "financial_account_id": null,
    "amount": "50.0",
    "description": "Service income"
  },
  {
    "id": "je_7",
    "date": "2025-06-03",
    "document_type": "Document",
    "document_id": "501695640642782222",
    "ledger_account_id": "123",
    "project_id": null,
    "contact_id": null,
    "tax_rate_id": null,
    "financial_account_id": null,
    "amount": "15.5",
    "description": "Small miscellaneous income"
  },
  {
    "id": "je_1",
    "date": "2025-06-01",
    "document_type": "Document",
    "document_id": "501695640621811702",
    "ledger_account_id": "123",
    "project_id": null,
    "contact_id": null,
    "tax_rate_id": null,
    "financial_account_id": null,
    "amount": "100.0",
    "description": "Revenue from sales"
  }
]

json

application/json

deprecated

Ledger account report

GET

https://moneybird.com/api/v2

/{administration_id}/reports/ledger_accounts/{ledger_account_id}{format}

This endpoint is deprecated and should no longer be used. It has been replaced by the Journal entries report.

Required scope(s)

documents and sales_invoices

Ledger account report › path 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

ledger_account_id

identifier · pattern: ^\d+$ · required

The ID of the ledger account to get the report for

A unique record identifier

Ledger account report › query Parameters

period

string · pattern: ^\d{6,8}(..\d{6,8})?…

The period can be a date range or one of the presets. Date ranges must consist of whole months (start on 1st, end on last day of month).

Date range formats:

YYYYMMDD..YYYYMMDD (e.g., 20250101..20250131)
YYYYMM..YYYYMM (e.g., 202501..202501)
YYYYMM (e.g., 202501)

Preset options:

this_month - Current month (default if not specified)
prev_month - Previous month
next_month - Next month
this_quarter - Current quarter
prev_quarter - Previous quarter
next_quarter - Next quarter
this_year - Current year
prev_year - Previous year
next_year - Next year

Maximum period: 12 months.

Default: this_month

page

integer | string

per_page

integer | string · min: 1 · max: 100 · pattern: ^\d+$

Ledger account report › Responses

A paginated list of ledger account bookings (journal entries)

object[]

id

string

administration_id

identifier · pattern: ^\d+$

A unique record identifier

date

string · date

document_type

string

document_id

identifier · pattern: ^\d+$

A unique record identifier

ledger_account_id

identifier · pattern: ^\d+$

A unique record identifier

project_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

contact_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

tax_rate_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

financial_account_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

amount

string

description

string

GET/{administration_id}/reports/ledger_accounts/{ledger_account_id}{format}

curl https://moneybird.com/api/v2/:administration_id/reports/ledger_accounts/:ledger_account_id:format \
  --header 'Authorization: Bearer <token>'

Example Responses

[
  {
    "id": "je_6",
    "date": "2025-06-14",
    "document_type": "Document",
    "document_id": "501695676168537487",
    "ledger_account_id": "123",
    "project_id": null,
    "contact_id": null,
    "tax_rate_id": null,
    "financial_account_id": null,
    "amount": "500.0",
    "description": "Large customer payment"
  },
  {
    "id": "je_5",
    "date": "2025-06-12",
    "document_type": "Document",
    "document_id": "501695676165391755",
    "ledger_account_id": "123",
    "project_id": null,
    "contact_id": null,
    "tax_rate_id": null,
    "financial_account_id": null,
    "amount": "-75.0",
    "description": "Credit note"
  },
  {
    "id": "je_3",
    "date": "2025-06-10",
    "document_type": "Document",
    "document_id": "501695676161197443",
    "ledger_account_id": "123",
    "project_id": null,
    "contact_id": null,
    "tax_rate_id": null,
    "financial_account_id": null,
    "amount": "250.0",
    "description": "Product sales"
  },
  {
    "id": "je_4",
    "date": "2025-06-08",
    "document_type": "Document",
    "document_id": "501695676163294599",
    "ledger_account_id": "123",
    "project_id": null,
    "contact_id": null,
    "tax_rate_id": null,
    "financial_account_id": null,
    "amount": "-25.0",
    "description": "Sales return"
  },
  {
    "id": "je_2",
    "date": "2025-06-05",
    "document_type": "Document",
    "document_id": "501695676159100287",
    "ledger_account_id": "123",
    "project_id": null,
    "contact_id": null,
    "tax_rate_id": null,
    "financial_account_id": null,
    "amount": "50.0",
    "description": "Service income"
  },
  {
    "id": "je_7",
    "date": "2025-06-03",
    "document_type": "Document",
    "document_id": "501695676170634643",
    "ledger_account_id": "123",
    "project_id": null,
    "contact_id": null,
    "tax_rate_id": null,
    "financial_account_id": null,
    "amount": "15.5",
    "description": "Small miscellaneous income"
  },
  {
    "id": "je_1",
    "date": "2025-06-01",
    "document_type": "Document",
    "document_id": "501695676154905979",
    "ledger_account_id": "123",
    "project_id": null,
    "contact_id": null,
    "tax_rate_id": null,
    "financial_account_id": null,
    "amount": "100.0",
    "description": "Revenue from sales"
  }
]

json

application/json

Profit loss report

GET

https://moneybird.com/api/v2

/{administration_id}/reports/profit_loss{format}

Get the profit loss report for the administration.

Every *_by_ledger_account section contains one item per ledger account with bookings in the period. Nested accounts are flat here: a parent's amount does not include its child accounts, which are listed as items of their own. Adding up all items in a section therefore gives that section's total without double counting.

The sections are not all signed the same way:

Section	Sign
revenue_by_ledger_account	credit minus debit, so revenue is positive
direct_costs_by_ledger_account	debit minus credit, so costs are positive
expenses_by_ledger_account	debit minus credit, so costs are positive
other_income_expenses_by_ledger_account	credit minus debit, so income is positive and expenses are negative

Sections can therefore not be added together as they are, and adding the three cost sections does not produce total_expenses. The description of each total says how that total is composed.

The fields at the top level always cover the whole period. With granularity, periods splits the same fields per month, quarter or year. Within a period, a section only lists the ledger accounts with bookings in that period.

Required scope(s)

documents and sales_invoices

Profit loss report › path 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

Profit loss report › query Parameters

period

string · pattern: ^\d{6,8}(..\d{6,8})?…

The period can be a date range or one of the presets. Date ranges must consist of whole months (start on 1st, end on last day of month).

Date range formats:

YYYYMMDD..YYYYMMDD (e.g., 20250101..20250131)
YYYYMM..YYYYMM (e.g., 202501..202501)
YYYYMM (e.g., 202501)

Preset options:

this_month - Current month (default if not specified)
prev_month - Previous month
next_month - Next month
this_quarter - Current quarter
prev_quarter - Previous quarter
next_quarter - Next quarter
this_year - Current year
prev_year - Previous year
next_year - Next year

Maximum period: 12 months.

Default: this_month

granularity

string · enum

Enum values:

month

quarter

year

project_id

identifier · pattern: ^\d+$

A unique record identifier

Profit loss report › Responses

A profit loss report

ledger_account_data

Data grouped by ledger account. Contains an array of ledger account entries with ledger_account_id and value.

ledger_account_data

Data grouped by ledger account. Contains an array of ledger account entries with ledger_account_id and value.

ledger_account_data

Data grouped by ledger account. Contains an array of ledger account entries with ledger_account_id and value.

ledger_account_data

Data grouped by ledger account. Contains an array of ledger account entries with ledger_account_id and value.

gross_profit

string

total_revenue minus the total of direct_costs_by_ledger_account

operating_profit

string

gross_profit minus the total of expenses_by_ledger_account, so excluding other income and expenses

net_profit

string

total_revenue minus total_expenses

total_expenses

string

The total of direct_costs_by_ledger_account plus expenses_by_ledger_account minus other_income_expenses_by_ledger_account

total_revenue

string

The total of revenue_by_ledger_account

object[]

Only present when granularity is given. One item for each month, quarter or year in period, oldest first.

GET/{administration_id}/reports/profit_loss{format}

curl https://moneybird.com/api/v2/:administration_id/reports/profit_loss:format \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "revenue_by_ledger_account": {
    "ledger_accounts": [
      {
        "ledger_account_id": "501695710210557133",
        "value": "100.0"
      }
    ]
  },
  "direct_costs_by_ledger_account": {
    "ledger_accounts": [
      {
        "ledger_account_id": "501695710215800018",
        "value": "20.0"
      }
    ]
  },
  "expenses_by_ledger_account": {
    "ledger_accounts": [
      {
        "ledger_account_id": "501695710218945751",
        "value": "15.0"
      }
    ]
  },
  "other_income_expenses_by_ledger_account": {
    "ledger_accounts": [
      {
        "ledger_account_id": "501695710223140060",
        "value": "1.0"
      }
    ]
  },
  "gross_profit": "80.0",
  "operating_profit": "65.0",
  "net_profit": "66.0",
  "total_expenses": "34.0",
  "total_revenue": "100.0"
}

json

application/json

Revenue by contact report

GET

https://moneybird.com/api/v2

/{administration_id}/reports/revenue_by_contact{format}

Returns a revenue by contact report for the specified administration.

With granularity, periods splits the amounts per month, quarter or year. Within a period, only the contacts on this page with bookings in that period are listed.

Required scope(s)

sales_invoices

Revenue by contact report › path 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

Revenue by contact report › query Parameters

period

string · pattern: ^\d{6,8}(..\d{6,8})?…

The period can be a date range or one of the presets. Date ranges must consist of whole months (start on 1st, end on last day of month).

Date range formats:

YYYYMMDD..YYYYMMDD (e.g., 20250101..20250131)
YYYYMM..YYYYMM (e.g., 202501..202501)
YYYYMM (e.g., 202501)

Preset options:

this_month - Current month (default if not specified)
prev_month - Previous month
next_month - Next month
this_quarter - Current quarter
prev_quarter - Previous quarter
next_quarter - Next quarter
this_year - Current year
prev_year - Previous year
next_year - Next year

Maximum period: 12 months.

Default: this_month

granularity

string · enum

Enum values:

month

quarter

year

page

integer | string

per_page

integer | string · min: 1 · max: 100 · pattern: ^\d+$

Revenue by contact report › Responses

Successful response

contact_report_item[]

object[]

Only present when granularity is given. One item for each month, quarter or year in period, oldest first.

GET/{administration_id}/reports/revenue_by_contact{format}

curl https://moneybird.com/api/v2/:administration_id/reports/revenue_by_contact:format \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "revenue_by_contact": [
    {
      "contact_id": "501695728262841815",
      "amount": "30.0"
    }
  ],
  "periods": [
    {
      "period": "202501..202501",
      "revenue_by_contact": [
        {
          "contact_id": "501695728262841815",
          "amount": "-50.0"
        }
      ]
    },
    {
      "period": "202502..202502",
      "revenue_by_contact": [
        {
          "contact_id": "501695728262841815",
          "amount": "80.0"
        }
      ]
    }
  ]
}

json

application/json

Revenue by project report

GET

https://moneybird.com/api/v2

/{administration_id}/reports/revenue_by_project{format}

Returns a revenue by project report for the specified administration.

With granularity, periods splits the amounts per month, quarter or year. Within a period, only the projects on this page with bookings in that period are listed.

Required scope(s)

sales_invoices

Revenue by project report › path 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

Revenue by project report › query Parameters

period

string · pattern: ^\d{6,8}(..\d{6,8})?…

The period can be a date range or one of the presets. Date ranges must consist of whole months (start on 1st, end on last day of month).

Date range formats:

YYYYMMDD..YYYYMMDD (e.g., 20250101..20250131)
YYYYMM..YYYYMM (e.g., 202501..202501)
YYYYMM (e.g., 202501)

Preset options:

this_month - Current month (default if not specified)
prev_month - Previous month
next_month - Next month
this_quarter - Current quarter
prev_quarter - Previous quarter
next_quarter - Next quarter
this_year - Current year
prev_year - Previous year
next_year - Next year

Maximum period: 12 months.

Default: this_month

granularity

string · enum

Enum values:

month

quarter

year

page

integer | string

per_page

integer | string · min: 1 · max: 100 · pattern: ^\d+$

Revenue by project report › Responses

Successful response

project_report_item[]

object[]

Only present when granularity is given. One item for each month, quarter or year in period, oldest first.

Subscriptions report

GET

https://moneybird.com/api/v2

/{administration_id}/reports/subscriptions{format}

Get the subscriptions report for the administration. All values are for the last month of the specified period. For example, this_year returns the values for December.

Required scope(s)

sales_invoices

Subscriptions report › path 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

Subscriptions report › query Parameters

period

string · pattern: ^\d{6,8}(..\d{6,8})?…

The period can be a date range or one of the presets. Date ranges must consist of whole months (start on 1st, end on last day of month).

Date range formats:

YYYYMMDD..YYYYMMDD (e.g., 20250101..20250131)
YYYYMM..YYYYMM (e.g., 202501..202501)
YYYYMM (e.g., 202501)

Preset options:

this_month - Current month (default if not specified)
prev_month - Previous month
next_month - Next month
this_quarter - Current quarter
prev_quarter - Previous quarter
next_quarter - Next quarter
this_year - Current year
prev_year - Previous year
next_year - Next year

Maximum period: 12 months.

Default: this_month

Subscriptions report › Responses

A subscriptions report

monthly_recurring_revenue

string

annual_run_rate

string

churn_rate

string

lifetime_value

string

Tax report

GET

https://moneybird.com/api/v2

/{administration_id}/reports/tax{format}

Get the tax report for the administration.

tax_rates at the top level always covers the whole period. With granularity, periods gives the same list per month, quarter or year. Within a period, only the tax rates with a non-zero amount in that period are listed.

Required scope(s)

documents and sales_invoices

Tax report › path 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

Tax report › query Parameters

period

string · pattern: ^\d{6,8}(..\d{6,8})?…

The period can be a date range or one of the presets. Date ranges must consist of whole months (start on 1st, end on last day of month).

Date range formats:

YYYYMMDD..YYYYMMDD (e.g., 20250101..20250131)
YYYYMM..YYYYMM (e.g., 202501..202501)
YYYYMM (e.g., 202501)

Preset options:

this_month - Current month (default if not specified)
prev_month - Previous month
next_month - Next month
this_quarter - Current quarter
prev_quarter - Previous quarter
next_quarter - Next quarter
this_year - Current year
prev_year - Previous year
next_year - Next year

Maximum period: 12 months.

Default: this_month

granularity

string · enum

Enum values:

month

quarter

year

Tax report › Responses

A tax report

object[]

Only present when granularity is given. One item for each month, quarter or year in period, oldest first.

GET/{administration_id}/reports/tax{format}

curl https://moneybird.com/api/v2/:administration_id/reports/tax:format \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "tax_rates": [
    {
      "tax_rate_id": "501695610625197194",
      "name": "21% btw",
      "percentage": "21.0",
      "report_reference": "NL/1a",
      "amount": "1200.0",
      "type": "sales_invoice",
      "tax": "252.0"
    },
    {
      "tax_rate_id": "501695610630440077",
      "name": "21% btw",
      "percentage": "21.0",
      "report_reference": "NL/5b",
      "amount": "900.0",
      "type": "purchase_invoice",
      "tax": "189.0"
    }
  ],
  "periods": [
    {
      "period": "202508..202508",
      "tax_rates": [
        {
          "tax_rate_id": "501695610625197194",
          "name": "21% btw",
          "percentage": "21.0",
          "report_reference": "NL/1a",
          "amount": "300.0",
          "type": "sales_invoice",
          "tax": "63.0"
        }
      ]
    },
    {
      "period": "202509..202509",
      "tax_rates": [
        {
          "tax_rate_id": "501695610625197194",
          "name": "21% btw",
          "percentage": "21.0",
          "report_reference": "NL/1a",
          "amount": "900.0",
          "type": "sales_invoice",
          "tax": "189.0"
        },
        {
          "tax_rate_id": "501695610630440077",
          "name": "21% btw",
          "percentage": "21.0",
          "report_reference": "NL/5b",
          "amount": "900.0",
          "type": "purchase_invoice",
          "tax": "189.0"
        }
      ]
    }
  ]
}

json

application/json

Working capital report

GET

https://moneybird.com/api/v2

/{administration_id}/reports/working_capital{format}

Get the working capital of the administration at the end of the specified period, with the same figures as the balance card on the reports page.

With granularity, periods also gives the working capital at the end of every month, quarter or year in the period.

Required scope(s)

bank

Working capital report › path 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

Working capital report › query Parameters

period

string · pattern: ^\d{6,8}(..\d{6,8})?…

The period can be a date range or one of the presets. Date ranges must consist of whole months (start on 1st, end on last day of month).

Date range formats:

YYYYMMDD..YYYYMMDD (e.g., 20250101..20250131)
YYYYMM..YYYYMM (e.g., 202501..202501)
YYYYMM (e.g., 202501)

Preset options:

this_month - Current month (default if not specified)
prev_month - Previous month
next_month - Next month
this_quarter - Current quarter
prev_quarter - Previous quarter
next_quarter - Next quarter
this_year - Current year
prev_year - Previous year
next_year - Next year

Maximum period: 12 months.

Default: this_month

granularity

string · enum

Enum values:

month

quarter

year

Working capital report › Responses

A working capital report

working_capital

string

Current assets minus current liabilities

bank

string

The balance of the financial accounts, or zero when that balance is negative

to_receive

string

The current assets other than bank

to_pay

string

The current liabilities, including a negative balance of the financial accounts

object[]

Only present when granularity is given. One item for each month, quarter or year in period, oldest first.

Recurring sales invoices Sales invoices