Documents: Purchase invoices

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

contact_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

reference

string | null

date

string · date

due_date

string | null · date

entry_number

integer | null

state

string · enum

Enum values:

new

open

late

paid

saved

pending_payment

currency

ISO 4217 currency code

exchange_rate

string | null

revenue_invoice

boolean | null

prices_are_incl_tax

boolean | null

origin

string | null · enum

Enum values:

upload

endpoint

si_local

si_peppol

api

moneybird_bv

paid_at

string | null · date

tax_number

string | null

total_price_excl_tax

string | null

total_price_excl_tax_base

string | null

total_price_incl_tax

string | null

total_price_incl_tax_base

string | null

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

POST/{administration_id}/documents/purchase_invoices/synchronization{format}

curl https://moneybird.com/api/v2/:administration_id/documents/purchase_invoices/synchronization:format \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "ids": [
    499053953140393600,
    499053953182336640
  ]
}'

Example Request Body

{
  "ids": [
    499053953140393600,
    499053953182336640
  ]
}

json

application/json

Example Responses

[
  {
    "id": "499053953140393619",
    "administration_id": 123,
    "contact_id": "499053953032390265",
    "contact": {
      "id": "499053953032390265",
      "administration_id": 123,
      "company_name": "Foobar Holding B.V.",
      "firstname": null,
      "lastname": null,
      "address1": "Hoofdstraat 12",
      "address2": null,
      "zipcode": "1234AB",
      "city": "Amsterdam",
      "country": "NL",
      "phone": null,
      "delivery_method": "Email",
      "customer_id": "customer-1",
      "tax_number": null,
      "chamber_of_commerce": null,
      "bank_account": null,
      "is_trusted": false,
      "max_transfer_amount": null,
      "attention": null,
      "email": "info@example.com",
      "email_ubl": true,
      "send_invoices_to_attention": null,
      "send_invoices_to_email": "info@example.com",
      "send_estimates_to_attention": null,
      "send_estimates_to_email": "info@example.com",
      "direct_debit": false,
      "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": "2026-09-23T09:15:59.228Z",
      "updated_at": "2026-09-23T09:15:59.228Z",
      "version": 1790154959,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000001/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "reference": "2013-01234",
    "date": "2026-09-23",
    "due_date": "2026-10-07",
    "entry_number": 3,
    "state": "open",
    "currency": "EUR",
    "exchange_rate": "1.0",
    "revenue_invoice": false,
    "prices_are_incl_tax": false,
    "origin": null,
    "paid_at": null,
    "tax_number": null,
    "total_price_excl_tax": "300.0",
    "total_price_excl_tax_base": "300.0",
    "total_price_incl_tax": "363.0",
    "total_price_incl_tax_base": "363.0",
    "created_at": "2026-09-23T09:15:59.331Z",
    "updated_at": "2026-09-23T09:15:59.334Z",
    "version": 1790154959,
    "details": [
      {
        "id": "499053953142490772",
        "administration_id": 123,
        "tax_rate_id": "499053794214020237",
        "ledger_account_id": "499053794017936505",
        "project_id": null,
        "product_id": null,
        "amount": null,
        "amount_decimal": "1.0",
        "description": "Delivery Apple iPad",
        "price": "300.0",
        "period": null,
        "row_order": 0,
        "total_price_excl_tax_with_discount": "300.0",
        "total_price_excl_tax_with_discount_base": "300.0",
        "tax_report_reference": [
          "NL/5b"
        ],
        "mandatory_tax_text": null,
        "created_at": "2026-09-23T09:15:59.333Z",
        "updated_at": "2026-09-23T09:15:59.333Z"
      }
    ],
    "fiscal_allocations": [],
    "payments": [],
    "notes": [],
    "attachments": [],
    "events": [
      {
        "administration_id": 123,
        "user_id": "499053793376207973",
        "action": "document_saved",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2026-09-23T09:15:59.337Z",
        "updated_at": "2026-09-23T09:15:59.337Z"
      }
    ]
  },
  {
    "id": "499053953182336671",
    "administration_id": 123,
    "contact_id": "499053953032390265",
    "contact": {
      "id": "499053953032390265",
      "administration_id": 123,
      "company_name": "Foobar Holding B.V.",
      "firstname": null,
      "lastname": null,
      "address1": "Hoofdstraat 12",
      "address2": null,
      "zipcode": "1234AB",
      "city": "Amsterdam",
      "country": "NL",
      "phone": null,
      "delivery_method": "Email",
      "customer_id": "customer-1",
      "tax_number": null,
      "chamber_of_commerce": null,
      "bank_account": null,
      "is_trusted": false,
      "max_transfer_amount": null,
      "attention": null,
      "email": "info@example.com",
      "email_ubl": true,
      "send_invoices_to_attention": null,
      "send_invoices_to_email": "info@example.com",
      "send_estimates_to_attention": null,
      "send_estimates_to_email": "info@example.com",
      "direct_debit": false,
      "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": "2026-09-23T09:15:59.228Z",
      "updated_at": "2026-09-23T09:15:59.228Z",
      "version": 1790154959,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000001/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "reference": "2013-01234",
    "date": "2026-09-23",
    "due_date": "2026-10-07",
    "entry_number": 4,
    "state": "open",
    "currency": "EUR",
    "exchange_rate": "1.0",
    "revenue_invoice": false,
    "prices_are_incl_tax": false,
    "origin": null,
    "paid_at": null,
    "tax_number": null,
    "total_price_excl_tax": "300.0",
    "total_price_excl_tax_base": "300.0",
    "total_price_incl_tax": "363.0",
    "total_price_incl_tax_base": "363.0",
    "created_at": "2026-09-23T09:15:59.371Z",
    "updated_at": "2026-09-23T09:15:59.374Z",
    "version": 1790154959,
    "details": [
      {
        "id": "499053953184433824",
        "administration_id": 123,
        "tax_rate_id": "499053794214020237",
        "ledger_account_id": "499053794017936505",
        "project_id": null,
        "product_id": null,
        "amount": null,
        "amount_decimal": "1.0",
        "description": "Delivery Apple iPad",
        "price": "300.0",
        "period": null,
        "row_order": 0,
        "total_price_excl_tax_with_discount": "300.0",
        "total_price_excl_tax_with_discount_base": "300.0",
        "tax_report_reference": [
          "NL/5b"
        ],
        "mandatory_tax_text": null,
        "created_at": "2026-09-23T09:15:59.373Z",
        "updated_at": "2026-09-23T09:15:59.373Z"
      }
    ],
    "fiscal_allocations": [],
    "payments": [],
    "notes": [],
    "attachments": [],
    "events": [
      {
        "administration_id": 123,
        "user_id": "499053793376207973",
        "action": "document_saved",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2026-09-23T09:15:59.377Z",
        "updated_at": "2026-09-23T09:15:59.377Z"
      }
    ]
  }
]

json

application/json

Download attachment

GET

https://moneybird.com/api/v2

/{administration_id}/documents/purchase_invoices/{id}/attachments/{attachment_id}/download{format}

Download the attachment. The response will be a redirect to a temporarily available URL where the attachment can be downloaded. Use the Location header in the response to download the attachment.

Required scope(s)

documents

Download attachment › 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

attachment_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

Download attachment › Responses

Found

string

Delete an attachment

DELETE

https://moneybird.com/api/v2

/{administration_id}/documents/purchase_invoices/{id}/attachments/{attachment_id}{format}

Deletes an attachment of an attachable.

Required scope(s)

documents

Delete an attachment › 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

attachment_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 an attachment › Responses

Attachment deleted

No data returned

Add attachment to purchase invoice

POST

https://moneybird.com/api/v2

/{administration_id}/documents/purchase_invoices/{id}/attachments{format}

Add an attachment to a purchase invoice.

Required scope(s)

documents

Add attachment to purchase invoice › 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

Add attachment to purchase invoice › Request Body

file

string · binary

Add attachment to purchase invoice › Responses

Status code

integer

Delete a payment

DELETE

https://moneybird.com/api/v2

/{administration_id}/documents/purchase_invoices/{id}/payments/{payment_id}{format}

Deletes a payment from a purchase invoice.

Required scope(s)

documents

Delete a payment › 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

payment_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 payment › Responses

Payment deleted

No data returned

Create a payment

POST

https://moneybird.com/api/v2

/{administration_id}/documents/purchase_invoices/{id}/payments{format}

Registers a payment for a purchase invoice.

Required scope(s)

documents

Create a payment › 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

Create a payment › Request Body

object

Create a payment › Responses

Payment created

payment_response

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

invoice_type

string · enum

Enum values:

SalesInvoice

Document

ExternalSalesInvoice

VatDocument

invoice_id

identifier · pattern: ^\d+$

A unique record identifier

financial_account_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

user_id

identifier · pattern: ^\d+$

A unique record identifier

payment_transaction_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

transaction_identifier

string | null

number

payment_date

string · date

credit_invoice_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

financial_mutation_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

ledger_account_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

linked_payment_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

manual_payment_action

string | null

created_at

timestamp · date-time

updated_at

timestamp · date-time

POST/{administration_id}/documents/purchase_invoices/{id}/payments{format}

curl https://moneybird.com/api/v2/:administration_id/documents/purchase_invoices/:id/payments:format \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "payment": {
    "payment_date": "2026-09-23T09:15:54.400Z",
    "price": "363.0"
  }
}'

Example Request Body

{
  "payment": {
    "payment_date": "2026-09-23T09:15:54.400Z",
    "price": "363.0"
  }
}

json

application/json

Example Responses

{
  "id": "499053947981399597",
  "administration_id": 123,
  "invoice_type": "Document",
  "invoice_id": "499053947917436437",
  "financial_account_id": null,
  "user_id": "499053793376207973",
  "payment_transaction_id": null,
  "transaction_identifier": null,
  "price": "363.0",
  "price_base": "363.0",
  "payment_date": "2026-09-23",
  "credit_invoice_id": null,
  "financial_mutation_id": null,
  "ledger_account_id": "499053794046248066",
  "linked_payment_id": null,
  "manual_payment_action": null,
  "created_at": "2026-09-23T09:15:54.412Z",
  "updated_at": "2026-09-23T09:15:54.412Z"
}

json

application/json

deprecated

Register a payment for a purchase invoice

PATCH

https://moneybird.com/api/v2

/{administration_id}/documents/purchase_invoices/{id}/register_payment{format}

This endpoint is deprecated and should no longer be used. It has been replaced by Create a payment.

Required scope(s)

documents

Register a payment for a purchase invoice › 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

Register a payment for a purchase invoice › Request Body

object

Register a payment for a purchase invoice › Responses

Status code

integer

Get purchase invoice

GET

https://moneybird.com/api/v2

/{administration_id}/documents/purchase_invoices/{id}{format}

Returns a purchase invoice by id.

Required scope(s)

documents

Get purchase invoice › 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 purchase invoice › Responses

A purchase invoice

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

contact_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

reference

string | null

date

string · date

due_date

string | null · date

entry_number

integer | null

state

string · enum

Enum values:

new

open

late

paid

saved

pending_payment

currency

ISO 4217 currency code

exchange_rate

string | null

revenue_invoice

boolean | null

prices_are_incl_tax

boolean | null

origin

string | null · enum

Enum values:

upload

endpoint

si_local

si_peppol

api

moneybird_bv

paid_at

string | null · date

tax_number

string | null

total_price_excl_tax

string | null

total_price_excl_tax_base

string | null

total_price_incl_tax

string | null

total_price_incl_tax_base

string | null

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

GET/{administration_id}/documents/purchase_invoices/{id}{format}

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

Example Responses

{
  "id": "499053945928287285",
  "administration_id": 123,
  "contact_id": "499053945901024307",
  "contact": {
    "id": "499053945901024307",
    "administration_id": 123,
    "company_name": "Foobar Holding B.V.",
    "firstname": null,
    "lastname": null,
    "address1": "Hoofdstraat 12",
    "address2": null,
    "zipcode": "1234AB",
    "city": "Amsterdam",
    "country": "NL",
    "phone": null,
    "delivery_method": "Email",
    "customer_id": "customer-1",
    "tax_number": null,
    "chamber_of_commerce": null,
    "bank_account": null,
    "is_trusted": false,
    "max_transfer_amount": null,
    "attention": null,
    "email": "info@example.com",
    "email_ubl": true,
    "send_invoices_to_attention": null,
    "send_invoices_to_email": "info@example.com",
    "send_estimates_to_attention": null,
    "send_estimates_to_email": "info@example.com",
    "direct_debit": false,
    "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": "2026-09-23T09:15:52.427Z",
    "updated_at": "2026-09-23T09:15:52.427Z",
    "version": 1790154952,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000001/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "reference": "2013-01234",
  "date": "2026-09-23",
  "due_date": "2026-10-07",
  "entry_number": 1,
  "state": "open",
  "currency": "EUR",
  "exchange_rate": "1.0",
  "revenue_invoice": false,
  "prices_are_incl_tax": false,
  "origin": null,
  "paid_at": null,
  "tax_number": null,
  "total_price_excl_tax": "300.0",
  "total_price_excl_tax_base": "300.0",
  "total_price_incl_tax": "363.0",
  "total_price_incl_tax_base": "363.0",
  "created_at": "2026-09-23T09:15:52.453Z",
  "updated_at": "2026-09-23T09:15:52.456Z",
  "version": 1790154952,
  "details": [
    {
      "id": "499053945929335862",
      "administration_id": 123,
      "tax_rate_id": "499053794214020237",
      "ledger_account_id": "499053794017936505",
      "project_id": null,
      "product_id": null,
      "amount": null,
      "amount_decimal": "1.0",
      "description": "Delivery Apple iPad",
      "price": "300.0",
      "period": null,
      "row_order": 0,
      "total_price_excl_tax_with_discount": "300.0",
      "total_price_excl_tax_with_discount_base": "300.0",
      "tax_report_reference": [
        "NL/5b"
      ],
      "mandatory_tax_text": null,
      "created_at": "2026-09-23T09:15:52.455Z",
      "updated_at": "2026-09-23T09:15:52.455Z"
    }
  ],
  "fiscal_allocations": [],
  "payments": [],
  "notes": [],
  "attachments": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": "499053793376207973",
      "action": "document_saved",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-09-23T09:15:52.459Z",
      "updated_at": "2026-09-23T09:15:52.459Z"
    }
  ]
}

json

application/json

Delete a purchase invoices

DELETE

https://moneybird.com/api/v2

/{administration_id}/documents/purchase_invoices/{id}{format}

Deletes a purchase invoice.

Required scope(s)

documents

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

Status code

integer

Update purchase invoice

PATCH

https://moneybird.com/api/v2

/{administration_id}/documents/purchase_invoices/{id}{format}

Updates a purchase invoice.

Required scope(s)

documents

Update purchase invoice › 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 purchase invoice › Request Body

object

Update purchase invoice › Responses

Purchase invoice updated

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

contact_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

reference

string | null

date

string · date

due_date

string | null · date

entry_number

integer | null

state

string · enum

Enum values:

new

open

late

paid

saved

pending_payment

currency

ISO 4217 currency code

exchange_rate

string | null

revenue_invoice

boolean | null

prices_are_incl_tax

boolean | null

origin

string | null · enum

Enum values:

upload

endpoint

si_local

si_peppol

api

moneybird_bv

paid_at

string | null · date

tax_number

string | null

total_price_excl_tax

string | null

total_price_excl_tax_base

string | null

total_price_incl_tax

string | null

total_price_incl_tax_base

string | null

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

purchase_invoice_response[]

PATCH/{administration_id}/documents/purchase_invoices/{id}{format}

curl https://moneybird.com/api/v2/:administration_id/documents/purchase_invoices/:id:format \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "purchase_invoice": {
    "fiscal_allocations_attributes": [
      {
        "ledger_account_id": 499053794017936500,
        "private_ledger_account_id": 499053951290705100,
        "percentage": "40"
      }
    ]
  }
}'

Example Request Body

{
  "purchase_invoice": {
    "fiscal_allocations_attributes": [
      {
        "ledger_account_id": 499053794017936500,
        "private_ledger_account_id": 499053951290705100,
        "percentage": "40"
      }
    ]
  }
}

json

application/json

Example Responses

{
  "id": "499053951271830684",
  "administration_id": 123,
  "contact_id": "499053951161730178",
  "contact": {
    "id": "499053951161730178",
    "administration_id": 123,
    "company_name": "Foobar Holding B.V.",
    "firstname": null,
    "lastname": null,
    "address1": "Hoofdstraat 12",
    "address2": null,
    "zipcode": "1234AB",
    "city": "Amsterdam",
    "country": "NL",
    "phone": null,
    "delivery_method": "Email",
    "customer_id": "customer-1",
    "tax_number": null,
    "chamber_of_commerce": null,
    "bank_account": null,
    "is_trusted": false,
    "max_transfer_amount": null,
    "attention": null,
    "email": "info@example.com",
    "email_ubl": true,
    "send_invoices_to_attention": null,
    "send_invoices_to_email": "info@example.com",
    "send_estimates_to_attention": null,
    "send_estimates_to_email": "info@example.com",
    "direct_debit": false,
    "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": "2026-09-23T09:15:57.444Z",
    "updated_at": "2026-09-23T09:15:57.444Z",
    "version": 1790154957,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000001/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "reference": "2013-01234",
  "date": "2026-09-23",
  "due_date": "2026-10-07",
  "entry_number": 3,
  "state": "open",
  "currency": "EUR",
  "exchange_rate": "1.0",
  "revenue_invoice": false,
  "prices_are_incl_tax": false,
  "origin": null,
  "paid_at": null,
  "tax_number": null,
  "total_price_excl_tax": "325.2",
  "total_price_excl_tax_base": "325.2",
  "total_price_incl_tax": "363.0",
  "total_price_incl_tax_base": "363.0",
  "created_at": "2026-09-23T09:15:57.549Z",
  "updated_at": "2026-09-23T09:15:57.603Z",
  "version": 1790154957,
  "details": [
    {
      "id": "499053951272879261",
      "administration_id": 123,
      "tax_rate_id": "499053794214020237",
      "ledger_account_id": "499053794017936505",
      "project_id": null,
      "product_id": null,
      "amount": null,
      "amount_decimal": "1.0",
      "description": "Delivery Apple iPad",
      "price": "300.0",
      "period": null,
      "row_order": 0,
      "total_price_excl_tax_with_discount": "180.0",
      "total_price_excl_tax_with_discount_base": "180.0",
      "tax_report_reference": [
        "NL/5b"
      ],
      "mandatory_tax_text": null,
      "created_at": "2026-09-23T09:15:57.551Z",
      "updated_at": "2026-09-23T09:15:57.602Z"
    }
  ],
  "fiscal_allocations": [
    {
      "id": "499053951325308073",
      "administration_id": 123,
      "ledger_account_id": "499053794017936505",
      "private_ledger_account_id": "499053951290705064",
      "percentage": "40.0",
      "price": "145.2",
      "price_base": "145.2",
      "created_at": "2026-09-23T09:15:57.600Z",
      "updated_at": "2026-09-23T09:15:57.600Z"
    }
  ],
  "payments": [],
  "notes": [],
  "attachments": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": "499053793376207973",
      "action": "document_saved",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-09-23T09:15:57.555Z",
      "updated_at": "2026-09-23T09:15:57.555Z"
    },
    {
      "administration_id": 123,
      "user_id": "499053793376207973",
      "action": "document_updated",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
        "changes": {
          "total_price_excl_tax": [
            "300.0",
            "325.2"
          ],
          "total_price_excl_tax_base": [
            "300.0",
            "325.2"
          ],
          "cached_taxes": [
            [
              {
                "tax_rate_id": "499053794214020237",
                "report_reference": "NL/5b",
                "payable": false,
                "debit": "63.0",
                "credit": 0
              }
            ],
            [
              {
                "tax_rate_id": "499053794214020237",
                "report_reference": "NL/5b",
                "payable": false,
                "debit": "37.8",
                "credit": 0
              }
            ]
          ],
          "updated_at": [
            "2026-09-23T11:15:57.552+02:00",
            "2026-09-23T11:15:57.599+02:00"
          ]
        }
      },
      "created_at": "2026-09-23T09:15:57.605Z",
      "updated_at": "2026-09-23T09:15:57.605Z"
    }
  ]
}

json

application/json

Destroys note from entity

DELETE

https://moneybird.com/api/v2

/{administration_id}/documents/purchase_invoices/{purchase_invoice_id}/notes/{id}{format}

Deletes a note from the purchase invoice.

Required scope(s)

documents

Destroys note from entity › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

purchase_invoice_id

identifier · pattern: ^\d+$ · required

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

Destroys note from entity › Responses

Note deleted

No data returned

Adds note to entity

POST

https://moneybird.com/api/v2

/{administration_id}/documents/purchase_invoices/{purchase_invoice_id}/notes{format}

Adds a note to the purchase invoice.

Required scope(s)

documents

Adds note to entity › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

purchase_invoice_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

Adds note to entity › Request Body

object

Adds note to entity › Responses

Note created

note_response

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

entity_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

entity_type

string

user_id

identifier · pattern: ^\d+$

A unique record identifier

assignee_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

todo

boolean | string | null

Default: false

note

string | null

completed_at

string | null · date-time

completed_by_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

todo_type

string | null · enum

Enum values:

sales_invoice_due

purchase_invoice_due

general_document_reminder

general_document_due

new_document_awaiting_processing

new_financial_mutation_awaiting_processing

financial_mutations_not_updated

sales_invoice_payment_not_linked_to_financial_mutation

data

object | null

created_at

timestamp · date-time

updated_at

timestamp · date-time

POST/{administration_id}/documents/purchase_invoices/{purchase_invoice_id}/notes{format}

curl https://moneybird.com/api/v2/:administration_id/documents/purchase_invoices/:purchase_invoice_id/notes:format \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "note": {
    "note": "Text of the note",
    "assignee_id": 499053950458136600,
    "todo": true
  }
}'

Example Request Body

{
  "note": {
    "note": "Text of the note",
    "assignee_id": 499053950458136600,
    "todo": true
  }
}

json

application/json

Example Responses

{
  "id": "499053950474913779",
  "administration_id": 123,
  "entity_id": "499053950399416281",
  "entity_type": "Document",
  "user_id": "499053793376207973",
  "assignee_id": "499053950458136561",
  "todo": true,
  "note": "Text of the note",
  "completed_at": null,
  "completed_by_id": null,
  "todo_type": null,
  "data": {},
  "created_at": "2026-09-23T09:15:56.789Z",
  "updated_at": "2026-09-23T09:15:56.789Z"
}

json

application/json

Get purchase invoices

GET

https://moneybird.com/api/v2

/{administration_id}/documents/purchase_invoices{format}

Returns a paginated list of documents of this type in the administration.

Required scope(s)

documents

Get purchase invoices › 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

Get purchase invoices › 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
period	`String`	`this_year`	A named 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 range (`201301..201302`, `20130101..20130131`)
state	`String`	`all`	`all`, `new`, `saved`, `open`, `paid`, `late` or `pending_payment`. `paid`, `late` and `pending_payment` only apply to documents with a payment lifecycle (purchase invoices and receipts)
recurring	`String`	`all`	`all`, `enabled` or `disabled`
attachment	`String`	`all`	`all`, `with` or `without`
reference	`String`		Documents with the given reference value
contact_id	`Integer`		Documents belonging to the given contact
ledger_account_id	`Integer`		Documents booking against the given ledger account
updated_after	`String`		ISO 8601 timestamp in UTC; documents updated strictly after this time

Multiple values for state, recurring and attachment can be combined with a pipe, e.g. state:open|paid.

Default: period:this_year

new_filter

string

String terms, example: key1:value1,key2:value2.

page

integer | string

per_page

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

Get purchase invoices › Responses

A list of purchase invoices

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

contact_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

reference

string | null

date

string · date

due_date

string | null · date

entry_number

integer | null

state

string · enum

Enum values:

new

open

late

paid

saved

pending_payment

currency

ISO 4217 currency code

exchange_rate

string | null

revenue_invoice

boolean | null

prices_are_incl_tax

boolean | null

origin

string | null · enum

Enum values:

upload

endpoint

si_local

si_peppol

api

moneybird_bv

paid_at

string | null · date

tax_number

string | null

total_price_excl_tax

string | null

total_price_excl_tax_base

string | null

total_price_incl_tax

string | null

total_price_incl_tax_base

string | null

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

GET/{administration_id}/documents/purchase_invoices{format}

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

Example Responses

[
  {
    "id": "499053947065992521",
    "administration_id": 123,
    "contact_id": "499053946869908759",
    "contact": {
      "id": "499053946869908759",
      "administration_id": 123,
      "company_name": "Foobar Holding B.V.",
      "firstname": null,
      "lastname": null,
      "address1": "Hoofdstraat 12",
      "address2": null,
      "zipcode": "1234AB",
      "city": "Amsterdam",
      "country": "NL",
      "phone": null,
      "delivery_method": "Email",
      "customer_id": "customer-1",
      "tax_number": null,
      "chamber_of_commerce": null,
      "bank_account": null,
      "is_trusted": false,
      "max_transfer_amount": null,
      "attention": null,
      "email": "info@example.com",
      "email_ubl": true,
      "send_invoices_to_attention": null,
      "send_invoices_to_email": "info@example.com",
      "send_estimates_to_attention": null,
      "send_estimates_to_email": "info@example.com",
      "direct_debit": false,
      "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": "2026-09-23T09:15:53.351Z",
      "updated_at": "2026-09-23T09:15:53.351Z",
      "version": 1790154953,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000001/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "reference": "2013-01234",
    "date": "2026-09-23",
    "due_date": "2026-10-07",
    "entry_number": 5,
    "state": "open",
    "currency": "EUR",
    "exchange_rate": "1.0",
    "revenue_invoice": false,
    "prices_are_incl_tax": false,
    "origin": null,
    "paid_at": null,
    "tax_number": null,
    "total_price_excl_tax": "300.0",
    "total_price_excl_tax_base": "300.0",
    "total_price_incl_tax": "363.0",
    "total_price_incl_tax_base": "363.0",
    "created_at": "2026-09-23T09:15:53.538Z",
    "updated_at": "2026-09-23T09:15:53.542Z",
    "version": 1790154953,
    "details": [
      {
        "id": "499053947068089674",
        "administration_id": 123,
        "tax_rate_id": "499053794214020237",
        "ledger_account_id": "499053794017936505",
        "project_id": null,
        "product_id": null,
        "amount": null,
        "amount_decimal": "1.0",
        "description": "Delivery Apple iPad",
        "price": "300.0",
        "period": null,
        "row_order": 0,
        "total_price_excl_tax_with_discount": "300.0",
        "total_price_excl_tax_with_discount_base": "300.0",
        "tax_report_reference": [
          "NL/5b"
        ],
        "mandatory_tax_text": null,
        "created_at": "2026-09-23T09:15:53.540Z",
        "updated_at": "2026-09-23T09:15:53.540Z"
      }
    ],
    "fiscal_allocations": [],
    "payments": [],
    "notes": [],
    "attachments": [],
    "events": [
      {
        "administration_id": 123,
        "user_id": "499053793376207973",
        "action": "document_saved",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2026-09-23T09:15:53.544Z",
        "updated_at": "2026-09-23T09:15:53.544Z"
      }
    ]
  }
]

json

application/json

Create a new purchase invoice

POST

https://moneybird.com/api/v2

/{administration_id}/documents/purchase_invoices{format}

Creates a new purchase invoice.

Required scope(s)

documents

Create a new purchase invoice › 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 purchase invoice › Request Body

object

Create a new purchase invoice › Responses

Purchase invoice created

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

contact_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

reference

string | null

date

string · date

due_date

string | null · date

entry_number

integer | null

state

string · enum

Enum values:

new

open

late

paid

saved

pending_payment

currency

ISO 4217 currency code

exchange_rate

string | null

revenue_invoice

boolean | null

prices_are_incl_tax

boolean | null

origin

string | null · enum

Enum values:

upload

endpoint

si_local

si_peppol

api

moneybird_bv

paid_at

string | null · date

tax_number

string | null

total_price_excl_tax

string | null

total_price_excl_tax_base

string | null

total_price_incl_tax

string | null

total_price_incl_tax_base

string | null

created_at

timestamp · date-time

updated_at

timestamp · date-time

version