Financial statements

Financial statements are comprised of financial mutations that are booked on a financial account. They provide a detailed record of all transactions for a specific account.

Delete a financial statement

DELETE

https://moneybird.com/api/v2

/{administration_id}/financial_statements/{id}{format}

Deletes a financial statement.

Required scope(s)

bank

Delete a financial statement › path 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

Delete a financial statement › Responses

Financial statement deleted

No data returned

Update a financial statement

PATCH

https://moneybird.com/api/v2

/{administration_id}/financial_statements/{id}{format}

When updating a financial statement, you only need to provide the information you want to change. Attributes you don't provide in the request will not be updated.

Required scope(s)

bank

Update a financial statement › path 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

Update a financial statement › Request Body

object

Update a financial statement › Responses

Financial statement updated

financial_statement_response

id

identifier · pattern: ^\d+$

A unique record identifier

financial_account_id

identifier · pattern: ^\d+$

A unique record identifier

reference

string

official_date

string | null · date

official_balance

string | null

importer_service

string | null

financial_mutation_response[]

PATCH/{administration_id}/financial_statements/{id}{format}

curl https://moneybird.com/api/v2/:administration_id/financial_statements/:id:format \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "financial_statement": {
    "reference": "new_reference",
    "financial_mutations_attributes": {
      "0": {
        "message": "Foobar 1",
        "date": "2026-09-23",
        "amount": 100
      }
    }
  }
}'

Example Request Body

{
  "financial_statement": {
    "reference": "new_reference",
    "financial_mutations_attributes": {
      "0": {
        "message": "Foobar 1",
        "date": "2026-09-23",
        "amount": 100
      }
    }
  }
}

json

application/json

Example Responses

{
  "id": "499053893073765805",
  "financial_account_id": "499053893001414058",
  "reference": "new_reference",
  "official_date": null,
  "official_balance": null,
  "importer_service": null,
  "financial_mutations": [
    {
      "id": "499053893076911535",
      "administration_id": 123,
      "amount": "-20.0",
      "code": null,
      "date": "2026-09-22",
      "message": "Afboeking",
      "contra_account_name": "Krant",
      "contra_account_number": "CH3608387000001080173",
      "state": "unprocessed",
      "settlement_state": "settled",
      "amount_open": "-20.0",
      "sepa_fields": null,
      "batch_reference": null,
      "financial_account_id": "499053893001414058",
      "currency": "EUR",
      "original_amount": null,
      "created_at": "2026-09-23T09:15:02.051Z",
      "updated_at": "2026-09-23T09:15:02.051Z",
      "version": 1790154902,
      "financial_statement_id": "499053893073765805",
      "processed_at": null,
      "account_servicer_transaction_id": null,
      "payments": [],
      "ledger_account_bookings": []
    },
    {
      "id": "499053893075862958",
      "administration_id": 123,
      "amount": "322.78",
      "code": null,
      "date": "2026-09-23",
      "message": "637034759 B & S CARD SERVICE GMBH\n0001234567EINREICH ABR.280000000\n321 / 333,60 -SERV 10,82 +0%MWST\n0,00 REF VU0251478",
      "contra_account_name": "Internetprovider",
      "contra_account_number": "BE68539007547034",
      "state": "unprocessed",
      "settlement_state": "settled",
      "amount_open": "322.78",
      "sepa_fields": null,
      "batch_reference": null,
      "financial_account_id": "499053893001414058",
      "currency": "EUR",
      "original_amount": null,
      "created_at": "2026-09-23T09:15:02.049Z",
      "updated_at": "2026-09-23T09:15:02.049Z",
      "version": 1790154902,
      "financial_statement_id": "499053893073765805",
      "processed_at": null,
      "account_servicer_transaction_id": null,
      "payments": [],
      "ledger_account_bookings": []
    },
    {
      "id": "499053893163943358",
      "administration_id": 123,
      "amount": "100.0",
      "code": null,
      "date": "2026-09-23",
      "message": "Foobar 1",
      "contra_account_name": null,
      "contra_account_number": "",
      "state": "unprocessed",
      "settlement_state": "settled",
      "amount_open": "100.0",
      "sepa_fields": null,
      "batch_reference": null,
      "financial_account_id": "499053893001414058",
      "currency": "EUR",
      "original_amount": null,
      "created_at": "2026-09-23T09:15:02.133Z",
      "updated_at": "2026-09-23T09:15:02.133Z",
      "version": 1790154902,
      "financial_statement_id": "499053893073765805",
      "processed_at": null,
      "account_servicer_transaction_id": null,
      "payments": [],
      "ledger_account_bookings": []
    }
  ]
}

json

application/json

Create a new financial statement

POST

https://moneybird.com/api/v2

/{administration_id}/financial_statements{format}

Creates a new financial statement. Provided financial mutations will be grouped in the statement.

Required scope(s)

bank

Create a new financial statement › 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

Create a new financial statement › Request Body

object

Create a new financial statement › Responses

Financial statement created

financial_statement_response

id

identifier · pattern: ^\d+$

A unique record identifier

financial_account_id

identifier · pattern: ^\d+$

A unique record identifier

reference

string

official_date

string | null · date

official_balance

string | null

importer_service

string | null

financial_mutation_response[]

POST/{administration_id}/financial_statements{format}

curl https://moneybird.com/api/v2/:administration_id/financial_statements:format \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "financial_statement": {
    "reference": "31012014_ABNAMRO",
    "financial_account_id": 499053893507876350,
    "financial_mutations_attributes": {
      "1": {
        "date": "2026-09-23",
        "message": "Foobar 1",
        "amount": 100
      },
      "2": {
        "date": "2026-09-23",
        "message": "Foobar 2",
        "amount": 200
      }
    }
  }
}'

Example Request Body

{
  "financial_statement": {
    "reference": "31012014_ABNAMRO",
    "financial_account_id": 499053893507876350,
    "financial_mutations_attributes": {
      "1": {
        "date": "2026-09-23",
        "message": "Foobar 1",
        "amount": 100
      },
      "2": {
        "date": "2026-09-23",
        "message": "Foobar 2",
        "amount": 200
      }
    }
  }
}

json

application/json

Example Responses

{
  "id": "499053893530945032",
  "financial_account_id": "499053893507876357",
  "reference": "31012014_ABNAMRO",
  "official_date": null,
  "official_balance": null,
  "importer_service": null,
  "financial_mutations": [
    {
      "id": "499053893531993609",
      "administration_id": 123,
      "amount": "100.0",
      "code": null,
      "date": "2026-09-23",
      "message": "Foobar 1",
      "contra_account_name": null,
      "contra_account_number": "",
      "state": "unprocessed",
      "settlement_state": "settled",
      "amount_open": "100.0",
      "sepa_fields": null,
      "batch_reference": null,
      "financial_account_id": "499053893507876357",
      "currency": "EUR",
      "original_amount": null,
      "created_at": "2026-09-23T09:15:02.484Z",
      "updated_at": "2026-09-23T09:15:02.484Z",
      "version": 1790154902,
      "financial_statement_id": "499053893530945032",
      "processed_at": null,
      "account_servicer_transaction_id": null,
      "payments": [],
      "ledger_account_bookings": []
    },
    {
      "id": "499053893534090762",
      "administration_id": 123,
      "amount": "200.0",
      "code": null,
      "date": "2026-09-23",
      "message": "Foobar 2",
      "contra_account_name": null,
      "contra_account_number": "",
      "state": "unprocessed",
      "settlement_state": "settled",
      "amount_open": "200.0",
      "sepa_fields": null,
      "batch_reference": null,
      "financial_account_id": "499053893507876357",
      "currency": "EUR",
      "original_amount": null,
      "created_at": "2026-09-23T09:15:02.486Z",
      "updated_at": "2026-09-23T09:15:02.486Z",
      "version": 1790154902,
      "financial_statement_id": "499053893530945032",
      "processed_at": null,
      "account_servicer_transaction_id": null,
      "payments": [],
      "ledger_account_bookings": []
    }
  ]
}

json

application/json

Financial mutations Identities