Purchase transactions

Purchase transactions are outgoing payments you initiate from Moneybird

deprecated

Delete a purchase transaction

DELETE

https://moneybird.com/api/v2

/{administration_id}/purchase_transactions/{id}/delete{format}

This endpoint is deprecated. Use the DELETE /purchase_transactions/{id} endpoint instead. Delete a purchase transaction. Requires that the purchase transaction is pending and doesn't belong to a purchase transaction batch.

Required scope(s)

bank

Delete a purchase transaction › 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 purchase transaction › Responses

Purchase transaction deleted

No data returned

Get a purchase transaction by id

GET

https://moneybird.com/api/v2

/{administration_id}/purchase_transactions/{id}{format}

Get a purchase transaction by id.

Required scope(s)

bank

Get a purchase transaction by id › 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

Get a purchase transaction by id › Responses

A purchase transaction

purchase_transaction_response

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

financial_account_id

identifier · pattern: ^\d+$

A unique record identifier

payment_instrument_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

state

string · enum

Enum values:

open

cancelled

paid

pending_payment

error

awaiting_authorization

preparing

sepa_iban

string

sepa_iban_account_name

string

sepa_bic

string

source_sepa_iban

string | null

source_sepa_iban_account_name

string | null

date

string | null · date

description

string

end_to_end_id

string

simple_contact_response

amount

string

created_at

timestamp · date-time

updated_at

timestamp · date-time

payable_type

string | null

payable_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

payment_method

string | null

GET/{administration_id}/purchase_transactions/{id}{format}

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

Example Responses

{
  "id": "499053942475326932",
  "administration_id": 123,
  "financial_account_id": "499053942451209676",
  "payment_instrument_id": null,
  "state": "open",
  "sepa_iban": "NL47TEST9876543210",
  "sepa_iban_account_name": "Test Inc.",
  "sepa_bic": "TESTNL22",
  "source_sepa_iban": null,
  "source_sepa_iban_account_name": null,
  "date": "2026-09-23",
  "description": "FOOBAR-2",
  "end_to_end_id": "FOOBAR-2",
  "contact": {
    "id": "499053942457501135",
    "administration_id": 123,
    "company_name": "Relation 2",
    "firstname": null,
    "lastname": null,
    "address1": null,
    "address2": null,
    "zipcode": null,
    "city": null,
    "country": "NL",
    "phone": null,
    "delivery_method": "Email",
    "customer_id": "customer-2",
    "tax_number": null,
    "chamber_of_commerce": null,
    "bank_account": "NL47TEST9876543210",
    "is_trusted": false,
    "max_transfer_amount": null,
    "attention": null,
    "email": "contact2@example.com",
    "email_ubl": false,
    "send_invoices_to_attention": null,
    "send_invoices_to_email": "contact2@example.com",
    "send_estimates_to_attention": null,
    "send_estimates_to_email": null,
    "direct_debit": false,
    "sepa_active": false,
    "sepa_iban": "NL47TEST9876543210",
    "sepa_iban_account_name": "Test Inc.",
    "sepa_bic": "TESTNL22",
    "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": "2026-09-23T09:15:49.143Z",
    "updated_at": "2026-09-23T09:15:49.143Z",
    "version": 1790154949,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000002/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "amount": "121.0",
  "created_at": "2026-09-23T09:15:49.161Z",
  "updated_at": "2026-09-23T09:15:49.161Z",
  "payable_type": "Document",
  "payable_id": "499053942467986898",
  "payment_method": null
}

json

application/json

Delete a purchase transaction

DELETE

https://moneybird.com/api/v2

/{administration_id}/purchase_transactions/{id}{format}

Delete a purchase transaction. Requires that the purchase transaction is pending and doesn't belong to a purchase transaction batch.

Required scope(s)

bank

Delete a purchase transaction › 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 purchase transaction › Responses

Purchase transaction deleted

No data returned

List all purchase transactions

GET

https://moneybird.com/api/v2

/{administration_id}/purchase_transactions{format}

Returns a list of purchase transactions in the administration.

Required scope(s)

bank

List all purchase transactions › 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

List all purchase transactions › query Parameters

filter

string

Filters are key:value terms separated by commas (e.g. period:this_year,state:open). Any filter you pass replaces the defaults below entirely, so include every key you need — in particular pass an explicit period (a named period or a YYYYMMDD..YYYYMMDD range) to look beyond the default financial year. Available filters:

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_week`, `prev_week`, `next_week`, `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.

Default: unbatched:true

page

integer | string

per_page

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

List all purchase transactions › Responses

200

A list of purchase transactions

purchase_transaction_response[]

purchase_transaction_response

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

financial_account_id

identifier · pattern: ^\d+$

A unique record identifier

payment_instrument_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

state

string · enum

Enum values:

open

cancelled

paid

pending_payment

error

awaiting_authorization

preparing

sepa_iban

string

sepa_iban_account_name

string

sepa_bic

string

source_sepa_iban

string | null

source_sepa_iban_account_name

string | null

date

string | null · date

description

string

end_to_end_id

string

simple_contact_response

amount

string

created_at

timestamp · date-time

updated_at

timestamp · date-time

payable_type

string | null

payable_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

payment_method

string | null

GET/{administration_id}/purchase_transactions{format}

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

Example Responses

[
  {
    "id": "499053942708110841",
    "administration_id": 123,
    "financial_account_id": "499053942702867959",
    "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": "2026-09-23",
    "description": "FOOBAR-1",
    "end_to_end_id": "FOOBAR-1",
    "contact": {
      "id": "499053942681896434",
      "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": "customer-1",
      "tax_number": null,
      "chamber_of_commerce": null,
      "bank_account": "NL47TEST9876543210",
      "is_trusted": false,
      "max_transfer_amount": null,
      "attention": null,
      "email": "contact1@example.com",
      "email_ubl": false,
      "send_invoices_to_attention": null,
      "send_invoices_to_email": "contact1@example.com",
      "send_estimates_to_attention": null,
      "send_estimates_to_email": null,
      "direct_debit": false,
      "sepa_active": false,
      "sepa_iban": "NL47TEST9876543210",
      "sepa_iban_account_name": "Test Inc.",
      "sepa_bic": "TESTNL22",
      "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": "2026-09-23T09:15:49.357Z",
      "updated_at": "2026-09-23T09:15:49.357Z",
      "version": 1790154949,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000001/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "amount": "121.0",
    "created_at": "2026-09-23T09:15:49.382Z",
    "updated_at": "2026-09-23T09:15:49.382Z",
    "payable_type": "Document",
    "payable_id": "499053942694479349",
    "payment_method": null
  }
]

json

application/json

Upload a SEPA credit transfer file to create purchase transaction batches

POST

https://moneybird.com/api/v2

/{administration_id}/sepa_credit_transfer{format}

Upload a SEPA credit transfer file (pain.001.001.09/Version 2019) to create purchase transaction batches. This endpoint requires an active Moneybird Banking account in the administration.

Required scope(s)

bank

Upload a SEPA credit transfer file to create purchase transaction batches › 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

Upload a SEPA credit transfer file to create purchase transaction batches › Request Body

file

string · binary · required

SEPA credit transfer file (pain.001.001.09/Version 2019)

ledger_account_id

identifier · pattern: ^\d+$

The ID of the ledger account that all transactions in the file will be booked on. If omitted, no booking is made and the bank transaction is left to automatic booking.

financial_account_id

identifier · pattern: ^\d+$

The ID of the Moneybird Banking financial account that will be linked to all the purchase transactions in the file. Must be an active Moneybird Banking account. If not provided, the financial account will be determined based on the debtor account in the file.

Upload a SEPA credit transfer file to create purchase transaction batches › Responses

Purchase transaction batches created successfully using the SEPA credit transfer file

purchase_transaction_batch_response[]

purchase_transaction_batch_response

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

financial_account_id

identifier · pattern: ^\d+$

A unique record identifier

state

string · enum

Enum values:

exported

cancelled

open

identifier

string

created_at

timestamp · date-time

updated_at

timestamp · date-time

POST/{administration_id}/sepa_credit_transfer{format}

curl https://moneybird.com/api/v2/:administration_id/sepa_credit_transfer:format \
  --request POST \
  --header 'Content-Type: multipart/form-data' \
  --header 'Authorization: Bearer <token>' \
  --form 'file=<binary>' \
  --form 'ledger_account_id=458026356994737217' \
  --form 'financial_account_id=458026356994737217'

Example Request Body

{
  "file": "<binary>",
  "ledger_account_id": "458026356994737217",
  "financial_account_id": "458026356994737217"
}

text

Example Responses

[
  {
    "id": "499053855621776607",
    "administration_id": 123,
    "financial_account_id": "499053855520064726",
    "state": "open",
    "identifier": "PMT20250910-STD",
    "created_at": "2025-09-12T00:00:00.000Z",
    "updated_at": "2025-09-12T00:00:00.000Z"
  },
  {
    "id": "499053855628068065",
    "administration_id": 123,
    "financial_account_id": "499053855530550489",
    "state": "open",
    "identifier": "PMT20250910-INST",
    "created_at": "2025-09-12T00:00:00.000Z",
    "updated_at": "2025-09-12T00:00:00.000Z"
  },
  {
    "id": "499053855632262371",
    "administration_id": 123,
    "financial_account_id": "499053855542084828",
    "state": "open",
    "identifier": "PMT20250910-SAL",
    "created_at": "2025-09-12T00:00:00.000Z",
    "updated_at": "2025-09-12T00:00:00.000Z"
  }
]

json

application/json

Projects Recurring sales invoices