Financial mutations

List all financial mutations

Returns a list of financial mutations in the administration. Limited to 100 financial mutations. If you need more financial mutations, use the synchronize API.

The filter argument allows you to filter on the list of financial mutations. Filters are a combination of keys and values, separated by a comma: key:value,key2:value2. The most common filter method will be period: period:this_month. Filtering works the same as in the web application, for more advanced examples, change the filtering in the web application and learn from the resulting URI.

Parameters

Parameter Type Description
filter String

Example: returns all financial mutations of an administration

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/financial_mutations.json?
    

Response

        
          
          Status: 200 OK
        
      
[
  {
    "id": "433546260558906372",
    "administration_id": 123,
    "amount": "100.0",
    "code": null,
    "date": "2024-09-30",
    "message": "Factuur",
    "contra_account_name": null,
    "contra_account_number": "",
    "state": "unprocessed",
    "amount_open": "100.0",
    "sepa_fields": null,
    "batch_reference": null,
    "financial_account_id": "433546260529546240",
    "currency": "EUR",
    "original_amount": null,
    "created_at": "2024-09-30T07:39:15.360Z",
    "updated_at": "2024-09-30T07:39:15.360Z",
    "version": 1727681955,
    "financial_statement_id": "433546260556809219",
    "processed_at": null,
    "account_servicer_transaction_id": null,
    "payments": [
      {
        "id": "433546260743455771",
        "administration_id": 123,
        "invoice_type": "SalesInvoice",
        "invoice_id": "433546260715144215",
        "financial_account_id": "433546260529546240",
        "user_id": 2,
        "payment_transaction_id": null,
        "transaction_identifier": null,
        "price": "80.0",
        "price_base": "80.0",
        "payment_date": "2024-09-30",
        "credit_invoice_id": null,
        "financial_mutation_id": "433546260558906372",
        "ledger_account_id": "433546260739261466",
        "linked_payment_id": null,
        "manual_payment_action": null,
        "created_at": "2024-09-30T07:39:15.534Z",
        "updated_at": "2024-09-30T07:39:15.534Z"
      }
    ],
    "ledger_account_bookings": [
      {
        "id": "433546260601897991",
        "administration_id": 123,
        "financial_mutation_id": "433546260558906372",
        "ledger_account_id": "433546260597703686",
        "project_id": null,
        "description": "Ledger account booking",
        "price": "20.0",
        "created_at": "2024-09-30T07:39:15.400Z",
        "updated_at": "2024-09-30T07:39:15.400Z"
      }
    ]
  }
]
      

Example: returns all mutations filtered on period

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/financial_mutations.json?filter=period%3Athis_month
    

Response

        
          
          Status: 200 OK
        
      
[
  {
    "id": "433546260861944864",
    "administration_id": 123,
    "amount": "100.0",
    "code": null,
    "date": "2024-09-30",
    "message": "Factuur",
    "contra_account_name": null,
    "contra_account_number": "",
    "state": "unprocessed",
    "amount_open": "100.0",
    "sepa_fields": null,
    "batch_reference": null,
    "financial_account_id": "433546260834681884",
    "currency": "EUR",
    "original_amount": null,
    "created_at": "2024-09-30T07:39:15.649Z",
    "updated_at": "2024-09-30T07:39:15.649Z",
    "version": 1727681955,
    "financial_statement_id": "433546260860896287",
    "processed_at": null,
    "account_servicer_transaction_id": null,
    "payments": [
      {
        "id": "433546261037057079",
        "administration_id": 123,
        "invoice_type": "SalesInvoice",
        "invoice_id": "433546261009794099",
        "financial_account_id": "433546260834681884",
        "user_id": 2,
        "payment_transaction_id": null,
        "transaction_identifier": null,
        "price": "80.0",
        "price_base": "80.0",
        "payment_date": "2024-09-30",
        "credit_invoice_id": null,
        "financial_mutation_id": "433546260861944864",
        "ledger_account_id": "433546261033911350",
        "linked_payment_id": null,
        "manual_payment_action": null,
        "created_at": "2024-09-30T07:39:15.815Z",
        "updated_at": "2024-09-30T07:39:15.815Z"
      }
    ],
    "ledger_account_bookings": [
      {
        "id": "433546260898645027",
        "administration_id": 123,
        "financial_mutation_id": "433546260861944864",
        "ledger_account_id": "433546260895499298",
        "project_id": null,
        "description": "Ledger account booking",
        "price": "20.0",
        "created_at": "2024-09-30T07:39:15.683Z",
        "updated_at": "2024-09-30T07:39:15.683Z"
      }
    ]
  }
]
      

Example: raises an error when there are too many mutations to return

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/financial_mutations.json?
    

Response

        
          
          Status: 400 Bad Request
        
      
{
  "error": "Too many financial mutations to return, please use sync API"
}
      

List all ids and versions

Returns all financial mutations in the administration. The list contains the id and the version of the financial mutation. Check if the version of the financial mutation is newer than the version you have stored locally, use the POST variant for fetching financial mutations with the given ids. The filter argument allows you to filter the list of financial mutations. Filters are a combination of keys and values, separated by a comma: period:this_year,state:all. The available options for filtering are:

Filter Type Default Description
period String this_year This can either be the description of a period (this_month, prev_month, next_month, this_quarter, prev_quarter, next_quarter, this_year, prev_year, next_year) or a custom period (201301..201302, 20130101..20130131)
state String   Can be all, unprocessed or processed
mutation_type String   Can be all, debit or credit
financial_account_id String    

Parameters

Parameter Type Description
filter String

Example: retrieves the id's for synchronization

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/financial_mutations/synchronization.json?
    

Response

        
          
          Status: 200 OK
        
      
[
  {
    "id": "433546262026912912",
    "version": 1727681956
  },
  {
    "id": "433546262045787283",
    "version": 1727681956
  },
  {
    "id": "433546262064661654",
    "version": 1727681956
  }
]
      

Example: retrieves the id's for synchronization with a filter

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/financial_mutations/synchronization.json?filter=period%3Athis_month
    

Response

        
          
          Status: 200 OK
        
      
[
  {
    "id": "433546262170567836",
    "version": 1727681956
  },
  {
    "id": "433546262189442207",
    "version": 1727681956
  },
  {
    "id": "433546262209365154",
    "version": 1727681956
  }
]
      

Example: retrieves only unique ids

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/financial_mutations/synchronization.json?
    

Response

        
          
          Status: 200 OK
        
      
[
  {
    "id": "433546262313174184",
    "version": 1727681957
  },
  {
    "id": "433546262330999979",
    "version": 1727681957
  },
  {
    "id": "433546262350922926",
    "version": 1727681957
  }
]
      

Fetch financial mutations with given ids

Given a list of financial mutation ids, returns the financial mutation information belonging to the financial mutation. Returns a maximum of 100 financial mutations, even if more ids are provided.

Parameters

Parameter Type Description
ids Array[integer]

Required

Example: it retrieves financial mutations given by ids

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XPOST \
  -d '{"ids":[433546262551200957,433546262569026752]}' \
  https://moneybird.com/api/v2/123/financial_mutations/synchronization.json
    

Response

        
          
          Status: 200 OK
        
      
[
  {
    "id": "433546262569026752",
    "administration_id": 123,
    "amount": "100.0",
    "code": null,
    "date": "2024-09-30",
    "message": "Factuur",
    "contra_account_name": null,
    "contra_account_number": "",
    "state": "unprocessed",
    "amount_open": "100.0",
    "sepa_fields": null,
    "batch_reference": null,
    "financial_account_id": "433546262505063606",
    "currency": "EUR",
    "original_amount": null,
    "created_at": "2024-09-30T07:39:17.276Z",
    "updated_at": "2024-09-30T07:39:17.276Z",
    "version": 1727681957,
    "financial_statement_id": "433546262566929599",
    "processed_at": null,
    "account_servicer_transaction_id": null,
    "payments": [

    ],
    "ledger_account_bookings": [

    ]
  },
  {
    "id": "433546262551200957",
    "administration_id": 123,
    "amount": "100.0",
    "code": null,
    "date": "2024-09-30",
    "message": "Factuur",
    "contra_account_name": null,
    "contra_account_number": "",
    "state": "unprocessed",
    "amount_open": "100.0",
    "sepa_fields": null,
    "batch_reference": null,
    "financial_account_id": "433546262505063606",
    "currency": "EUR",
    "original_amount": null,
    "created_at": "2024-09-30T07:39:17.259Z",
    "updated_at": "2024-09-30T07:39:17.259Z",
    "version": 1727681957,
    "financial_statement_id": "433546262549103804",
    "processed_at": null,
    "account_servicer_transaction_id": null,
    "payments": [

    ],
    "ledger_account_bookings": [

    ]
  }
]
      

Get a financial mutation by id

Returns a single financial mutation in the administration.

Example: returns financial mutation by the given id

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/financial_mutations/433546261439710296.json?
    

Response

        
          
          Status: 200 OK
        
      
{
  "id": "433546261439710296",
  "administration_id": 123,
  "amount": "100.0",
  "code": null,
  "date": "2024-09-30",
  "message": "Factuur",
  "contra_account_name": null,
  "contra_account_number": "",
  "state": "unprocessed",
  "amount_open": "100.0",
  "sepa_fields": null,
  "batch_reference": null,
  "financial_account_id": "433546261414544468",
  "currency": "EUR",
  "original_amount": null,
  "created_at": "2024-09-30T07:39:16.200Z",
  "updated_at": "2024-09-30T07:39:16.200Z",
  "version": 1727681956,
  "financial_statement_id": "433546261438661719",
  "processed_at": null,
  "account_servicer_transaction_id": null,
  "payments": [
    {
      "id": "433546261611676783",
      "administration_id": 123,
      "invoice_type": "SalesInvoice",
      "invoice_id": "433546261587559531",
      "financial_account_id": "433546261414544468",
      "user_id": 2,
      "payment_transaction_id": null,
      "transaction_identifier": null,
      "price": "80.0",
      "price_base": "80.0",
      "payment_date": "2024-09-30",
      "credit_invoice_id": null,
      "financial_mutation_id": "433546261439710296",
      "ledger_account_id": "433546261608531054",
      "linked_payment_id": null,
      "manual_payment_action": null,
      "created_at": "2024-09-30T07:39:16.363Z",
      "updated_at": "2024-09-30T07:39:16.363Z"
    }
  ],
  "ledger_account_bookings": [
    {
      "id": "433546261477459035",
      "administration_id": 123,
      "financial_mutation_id": "433546261439710296",
      "ledger_account_id": "433546261474313306",
      "project_id": null,
      "description": "Ledger account booking",
      "price": "20.0",
      "created_at": "2024-09-30T07:39:16.235Z",
      "updated_at": "2024-09-30T07:39:16.235Z"
    }
  ]
}
      

Example: returns 404 when the financial mutation does not exist

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/financial_mutations/34123123.json?
    

Response

        
          
          Status: 404 Not Found
        
      
{
  "error": "record not found",
  "symbolic": {
    "id": "not_found"
  }
}