Moneybird API

Purchase transactions

Endpointhttps://moneybird.com/api/v2

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.

Delete a purchase transaction › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · 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

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

curl --request DELETE \
  --url https://moneybird.com/api/v2/:administration_id/purchase_transactions/:id/delete:format

shell

Example Responses

No example specified for this content type

Get a purchase transaction by id

GET

https://moneybird.com/api/v2

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

Get a purchase transaction by id.

Get a purchase transaction by id › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · 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

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

financial_account_id

string | integer · pattern: ^\d+$

A unique record identifier

payment_instrument_id

string | integer | null · 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

object

amount

string

created_at

string · date-time

updated_at

string · date-time

payable_type

string | null

payable_id

string | integer | null · pattern: ^\d+$

A unique record identifier

payment_method

string | null

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

curl --request GET \
  --url https://moneybird.com/api/v2/:administration_id/purchase_transactions/:id:format

shell

Example Responses

{
  "id": "471699877227661242",
  "administration_id": 123,
  "financial_account_id": "471699877201446834",
  "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": "2025-11-25",
  "description": "FOOBAR-2",
  "end_to_end_id": "FOOBAR-2",
  "contact": {
    "id": "471699877207738293",
    "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,
    "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": "2025-11-25T10:54:39.666Z",
    "updated_at": "2025-11-25T10:54:39.666Z",
    "version": 1764068079,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000002/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "amount": "121.0",
  "created_at": "2025-11-25T10:54:39.684Z",
  "updated_at": "2025-11-25T10:54:39.684Z",
  "payable_type": "Document",
  "payable_id": "471699877220321208",
  "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.

Delete a purchase transaction › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · 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

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

curl --request DELETE \
  --url https://moneybird.com/api/v2/:administration_id/purchase_transactions/:id:format

shell

Example Responses

No example specified for this content type

List all purchase transactions

GET

https://moneybird.com/api/v2

/{administration_id}/purchase_transactions{format}

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.

List all purchase transactions › path Parameters

administration_id

string | integer · 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

page

integer | string

per_page

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

List all purchase transactions › Responses

200

A list of purchase transactions

object[]

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

financial_account_id

string | integer · pattern: ^\d+$

A unique record identifier

payment_instrument_id

string | integer | null · 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

object

amount

string

created_at

string · date-time

updated_at

string · date-time

payable_type

string | null

payable_id

string | integer | null · pattern: ^\d+$

A unique record identifier

payment_method

string | null

GET/{administration_id}/purchase_transactions{format}

curl --request GET \
  --url https://moneybird.com/api/v2/:administration_id/purchase_transactions:format

shell

Example Responses

[
  {
    "id": "471699877397530581",
    "administration_id": 123,
    "financial_account_id": "471699877392287699",
    "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-11-25",
    "description": "FOOBAR-1",
    "end_to_end_id": "FOOBAR-1",
    "contact": {
      "id": "471699877372364750",
      "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,
      "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": "2025-11-25T10:54:39.822Z",
      "updated_at": "2025-11-25T10:54:39.822Z",
      "version": 1764068079,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000001/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "amount": "121.0",
    "created_at": "2025-11-25T10:54:39.847Z",
    "updated_at": "2025-11-25T10:54:39.847Z",
    "payable_type": "Document",
    "payable_id": "471699877383899089",
    "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.

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

administration_id

string | integer · 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

string | integer · pattern: ^\d+$

The ID of the ledger account that will be linked to all the purchase transactions in the file

financial_account_id

string | integer · pattern: ^\d+$

The ID of the financial account that will be linked to all the purchase transactions in the file, 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

object[]

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

financial_account_id

string | integer · pattern: ^\d+$

A unique record identifier

state

string · enum

Enum values:

exported

cancelled

open

identifier

string

created_at

string · date-time

updated_at

string · date-time

POST/{administration_id}/sepa_credit_transfer{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/sepa_credit_transfer:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "file": "file",
  "ledger_account_id": "458026356994737217",
  "financial_account_id": "458026356994737217"
}
'

shell

Example Request Body

{
  "file": "file",
  "ledger_account_id": "458026356994737217",
  "financial_account_id": "458026356994737217"
}

json

Example Responses

[
  {
    "id": "471699919723299845",
    "administration_id": 123,
    "financial_account_id": "471699919633123324",
    "state": "open",
    "identifier": "PMT20250910-STD",
    "created_at": "2025-09-12T00:00:00.000Z",
    "updated_at": "2025-09-12T00:00:00.000Z"
  },
  {
    "id": "471699919726445575",
    "administration_id": 123,
    "financial_account_id": "471699919644657663",
    "state": "open",
    "identifier": "PMT20250910-INST",
    "created_at": "2025-09-12T00:00:00.000Z",
    "updated_at": "2025-09-12T00:00:00.000Z"
  },
  {
    "id": "471699919730639881",
    "administration_id": 123,
    "financial_account_id": "471699919654093826",
    "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

Moneybird API

Purchase transactions

Endpointhttps://moneybird.com/api/v2

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}

Delete a purchase transaction › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · 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

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

curl --request DELETE \
  --url https://moneybird.com/api/v2/:administration_id/purchase_transactions/:id/delete:format

shell

Example Responses

No example specified for this content type

Get a purchase transaction by id

GET

https://moneybird.com/api/v2

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

Get a purchase transaction by id.

Get a purchase transaction by id › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · 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

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

financial_account_id

string | integer · pattern: ^\d+$

A unique record identifier

payment_instrument_id

string | integer | null · 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

object

amount

string

created_at

string · date-time

updated_at

string · date-time

payable_type

string | null

payable_id

string | integer | null · pattern: ^\d+$

A unique record identifier

payment_method

string | null

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

curl --request GET \
  --url https://moneybird.com/api/v2/:administration_id/purchase_transactions/:id:format

shell

Example Responses

{
  "id": "471699877227661242",
  "administration_id": 123,
  "financial_account_id": "471699877201446834",
  "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": "2025-11-25",
  "description": "FOOBAR-2",
  "end_to_end_id": "FOOBAR-2",
  "contact": {
    "id": "471699877207738293",
    "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,
    "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": "2025-11-25T10:54:39.666Z",
    "updated_at": "2025-11-25T10:54:39.666Z",
    "version": 1764068079,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000002/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "amount": "121.0",
  "created_at": "2025-11-25T10:54:39.684Z",
  "updated_at": "2025-11-25T10:54:39.684Z",
  "payable_type": "Document",
  "payable_id": "471699877220321208",
  "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.

Delete a purchase transaction › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · 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

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

curl --request DELETE \
  --url https://moneybird.com/api/v2/:administration_id/purchase_transactions/:id:format

shell

Example Responses

No example specified for this content type

List all purchase transactions

GET

https://moneybird.com/api/v2

/{administration_id}/purchase_transactions{format}

Returns a list of all purchase transactions in the administration.

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.

List all purchase transactions › path Parameters

administration_id

string | integer · 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

page

integer | string

per_page

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

List all purchase transactions › Responses

200

A list of purchase transactions

object[]

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

financial_account_id

string | integer · pattern: ^\d+$

A unique record identifier

payment_instrument_id

string | integer | null · 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

object

amount

string

created_at

string · date-time

updated_at

string · date-time

payable_type

string | null

payable_id

string | integer | null · pattern: ^\d+$

A unique record identifier

payment_method

string | null

GET/{administration_id}/purchase_transactions{format}

curl --request GET \
  --url https://moneybird.com/api/v2/:administration_id/purchase_transactions:format

shell

Example Responses

[
  {
    "id": "471699877397530581",
    "administration_id": 123,
    "financial_account_id": "471699877392287699",
    "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-11-25",
    "description": "FOOBAR-1",
    "end_to_end_id": "FOOBAR-1",
    "contact": {
      "id": "471699877372364750",
      "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,
      "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": "2025-11-25T10:54:39.822Z",
      "updated_at": "2025-11-25T10:54:39.822Z",
      "version": 1764068079,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000001/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "amount": "121.0",
    "created_at": "2025-11-25T10:54:39.847Z",
    "updated_at": "2025-11-25T10:54:39.847Z",
    "payable_type": "Document",
    "payable_id": "471699877383899089",
    "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.

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

administration_id

string | integer · 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

string | integer · pattern: ^\d+$

The ID of the ledger account that will be linked to all the purchase transactions in the file

financial_account_id

string | integer · pattern: ^\d+$

The ID of the financial account that will be linked to all the purchase transactions in the file, 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

object[]

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

financial_account_id

string | integer · pattern: ^\d+$

A unique record identifier

state

string · enum

Enum values:

exported

cancelled

open

identifier

string

created_at

string · date-time

updated_at

string · date-time

POST/{administration_id}/sepa_credit_transfer{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/sepa_credit_transfer:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "file": "file",
  "ledger_account_id": "458026356994737217",
  "financial_account_id": "458026356994737217"
}
'

shell

Example Request Body

{
  "file": "file",
  "ledger_account_id": "458026356994737217",
  "financial_account_id": "458026356994737217"
}

json

Example Responses

[
  {
    "id": "471699919723299845",
    "administration_id": 123,
    "financial_account_id": "471699919633123324",
    "state": "open",
    "identifier": "PMT20250910-STD",
    "created_at": "2025-09-12T00:00:00.000Z",
    "updated_at": "2025-09-12T00:00:00.000Z"
  },
  {
    "id": "471699919726445575",
    "administration_id": 123,
    "financial_account_id": "471699919644657663",
    "state": "open",
    "identifier": "PMT20250910-INST",
    "created_at": "2025-09-12T00:00:00.000Z",
    "updated_at": "2025-09-12T00:00:00.000Z"
  },
  {
    "id": "471699919730639881",
    "administration_id": 123,
    "financial_account_id": "471699919654093826",
    "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