Purchase transactions

List all purchase transactions

Returns a list of all purchase transactions in the administration.

The filter argument allows you to filter the list of invoices. Filters are a combination of keys and values, separated by a comma: period:this_year,state:open. The available options for filtering are:

Filter Type Default Description
state String all all, open, pending_payment, paid or cancelled
period String nil 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)
unbatched Boolean true true or false

You can filter by multiple states at the same time as well. To do this, separate the state values by a pipe: state:open|pending_payment.

Parameters

Parameter Type Description
filter String
per_page Integer

Example: returns all purchase transactions of an administration

Request

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

Response

        
          
          Status: 200 OK
        
      
[
  {
    "id": "449763688917764044",
    "administration_id": 123,
    "financial_account_id": "449763688908326858",
    "payment_instrument_id": null,
    "state": "open",
    "sepa_iban": "NL47TEST9876543210",
    "sepa_iban_account_name": "Test Inc.",
    "sepa_bic": "TESTNL22",
    "source_sepa_iban": "NL28INGB0000000001",
    "source_sepa_iban_account_name": "ING NL28INGB0000000001",
    "date": "2025-03-28",
    "description": "FOOBAR-1",
    "end_to_end_id": "FOOBAR-1",
    "contact": {
      "id": "449763688877918149",
      "administration_id": 123,
      "company_name": "Relation 1",
      "firstname": null,
      "lastname": null,
      "address1": null,
      "address2": null,
      "zipcode": null,
      "city": null,
      "country": "NL",
      "phone": null,
      "delivery_method": "Email",
      "customer_id": "ea8c6a915176db74938ce3a1a71d7f9facfb171fc946aeef613e22090ba6bf2a",
      "tax_number": null,
      "chamber_of_commerce": null,
      "bank_account": null,
      "is_trusted": false,
      "max_transfer_amount": null,
      "attention": null,
      "email": null,
      "email_ubl": false,
      "send_invoices_to_attention": null,
      "send_invoices_to_email": null,
      "send_estimates_to_attention": null,
      "send_estimates_to_email": null,
      "sepa_active": false,
      "sepa_iban": null,
      "sepa_iban_account_name": null,
      "sepa_bic": null,
      "sepa_mandate_id": null,
      "sepa_mandate_date": null,
      "sepa_sequence_type": "RCUR",
      "credit_card_number": null,
      "credit_card_reference": null,
      "credit_card_type": null,
      "tax_number_validated_at": null,
      "tax_number_valid": null,
      "invoice_workflow_id": null,
      "estimate_workflow_id": null,
      "si_identifier": null,
      "si_identifier_type": null,
      "moneybird_payments_mandate": false,
      "created_at": "2025-03-28T07:48:20.255Z",
      "updated_at": "2025-03-28T07:48:20.255Z",
      "version": 1743148100,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/8b2e81a365ab18f3223d854fb91d1900cd0ca4cb370348a3cfe9cf81005a28b3/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "amount": "121.0",
    "created_at": "2025-03-28T07:48:20.294Z",
    "updated_at": "2025-03-28T07:48:20.294Z",
    "payable_type": "Document",
    "payable_id": "449763688895743944",
    "payment_method": null
  }
]
      

Example: returns all purchase transactions filtered on period

Request

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

Response

        
          
          Status: 200 OK
        
      
[
  {
    "id": "449763689081341909",
    "administration_id": 123,
    "financial_account_id": "449763689072953299",
    "payment_instrument_id": null,
    "state": "open",
    "sepa_iban": "NL47TEST9876543210",
    "sepa_iban_account_name": "Test Inc.",
    "sepa_bic": "TESTNL22",
    "source_sepa_iban": "NL28INGB0000000001",
    "source_sepa_iban_account_name": "ING NL28INGB0000000001",
    "date": "2025-03-28",
    "description": "FOOBAR-1",
    "end_to_end_id": "FOOBAR-1",
    "contact": {
      "id": "449763689038350286",
      "administration_id": 123,
      "company_name": "Relation 1",
      "firstname": null,
      "lastname": null,
      "address1": null,
      "address2": null,
      "zipcode": null,
      "city": null,
      "country": "NL",
      "phone": null,
      "delivery_method": "Email",
      "customer_id": "d1e1e0fd259c2927a0de227667bede54752b561a2417dda8d67c877842303935",
      "tax_number": null,
      "chamber_of_commerce": null,
      "bank_account": null,
      "is_trusted": false,
      "max_transfer_amount": null,
      "attention": null,
      "email": null,
      "email_ubl": false,
      "send_invoices_to_attention": null,
      "send_invoices_to_email": null,
      "send_estimates_to_attention": null,
      "send_estimates_to_email": null,
      "sepa_active": false,
      "sepa_iban": null,
      "sepa_iban_account_name": null,
      "sepa_bic": null,
      "sepa_mandate_id": null,
      "sepa_mandate_date": null,
      "sepa_sequence_type": "RCUR",
      "credit_card_number": null,
      "credit_card_reference": null,
      "credit_card_type": null,
      "tax_number_validated_at": null,
      "tax_number_valid": null,
      "invoice_workflow_id": null,
      "estimate_workflow_id": null,
      "si_identifier": null,
      "si_identifier_type": null,
      "moneybird_payments_mandate": false,
      "created_at": "2025-03-28T07:48:20.409Z",
      "updated_at": "2025-03-28T07:48:20.409Z",
      "version": 1743148100,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/fbed352751d68a66056ab413a99f0e816fe9fd4ace25290975282f2e34ebbd6d/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "amount": "121.0",
    "created_at": "2025-03-28T07:48:20.450Z",
    "updated_at": "2025-03-28T07:48:20.450Z",
    "payable_type": "Document",
    "payable_id": "449763689061418961",
    "payment_method": null
  }
]
      

Get a purchase transaction by id

Delete a purchase transaction