External sales 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

date

string · date

state

string · enum

Enum values:

new

open

late

paid

uncollectible

pending_payment

due_date

string | null · date

reference

string | null

entry_number

integer

origin

string | null · enum

Enum values:

upload

endpoint

si_local

si_peppol

api

moneybird_bv

source

string | null

source_url

string | null

currency

ISO 4217 currency code

paid_at

string | null · date

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

total_paid

string

total_unpaid

string

total_unpaid_base

string

prices_are_incl_tax

boolean

total_price_excl_tax

string

total_price_excl_tax_base

string

total_price_incl_tax

string

total_price_incl_tax_base

string

marked_dubious_on

string | null · date

marked_uncollectible_on

string | null · date

POST/{administration_id}/external_sales_invoices/synchronization{format}

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

Example Request Body

{
  "ids": [
    499053957265491800,
    499053957281220500
  ]
}

json

application/json

Example Responses

[
  {
    "id": "499053957281220449",
    "administration_id": 123,
    "contact_id": "499053957273880416",
    "contact": {
      "id": "499053957273880416",
      "administration_id": 123,
      "company_name": "Relation 3",
      "firstname": null,
      "lastname": null,
      "address1": null,
      "address2": null,
      "zipcode": null,
      "city": null,
      "country": "NL",
      "phone": null,
      "delivery_method": "Email",
      "customer_id": "customer-3",
      "tax_number": null,
      "chamber_of_commerce": null,
      "bank_account": null,
      "is_trusted": false,
      "max_transfer_amount": null,
      "attention": null,
      "email": "invoices@example.com",
      "email_ubl": false,
      "send_invoices_to_attention": null,
      "send_invoices_to_email": "invoices@example.com",
      "send_estimates_to_attention": null,
      "send_estimates_to_email": "estimates@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:16:03.273Z",
      "updated_at": "2026-09-23T09:16:03.273Z",
      "version": 1790154963,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000003/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "date": "2026-09-23",
    "state": "open",
    "due_date": null,
    "reference": "Invoice 3",
    "entry_number": 103,
    "origin": null,
    "source": null,
    "source_url": null,
    "currency": "EUR",
    "paid_at": null,
    "created_at": "2026-09-23T09:16:03.280Z",
    "updated_at": "2026-09-23T09:16:03.283Z",
    "version": 1790154963,
    "details": [
      {
        "id": "499053957282269026",
        "administration_id": 123,
        "tax_rate_id": "499053794204583050",
        "ledger_account_id": "499053794017936506",
        "project_id": null,
        "product_id": null,
        "amount": "1 x",
        "amount_decimal": "1.0",
        "description": "Invoice detail description",
        "price": "100.0",
        "period": null,
        "row_order": 0,
        "total_price_excl_tax_with_discount": "100.0",
        "total_price_excl_tax_with_discount_base": "100.0",
        "tax_report_reference": [],
        "mandatory_tax_text": null,
        "created_at": "2026-09-23T09:16:03.281Z",
        "updated_at": "2026-09-23T09:16:03.281Z"
      }
    ],
    "payments": [],
    "total_paid": "0.0",
    "total_unpaid": "121.0",
    "total_unpaid_base": "121.0",
    "prices_are_incl_tax": false,
    "total_price_excl_tax": "100.0",
    "total_price_excl_tax_base": "100.0",
    "total_price_incl_tax": "121.0",
    "total_price_incl_tax_base": "121.0",
    "marked_dubious_on": null,
    "marked_uncollectible_on": null,
    "notes": [],
    "attachments": [],
    "events": [],
    "tax_totals": [
      {
        "tax_rate_id": "499053794204583050",
        "taxable_amount": "100.0",
        "taxable_amount_base": "100.0",
        "tax_amount": "21.0",
        "tax_amount_base": "21.0"
      }
    ]
  },
  {
    "id": "499053957265491805",
    "administration_id": 123,
    "contact_id": "499053957258151772",
    "contact": {
      "id": "499053957258151772",
      "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": null,
      "is_trusted": false,
      "max_transfer_amount": null,
      "attention": null,
      "email": "invoices@example.com",
      "email_ubl": false,
      "send_invoices_to_attention": null,
      "send_invoices_to_email": "invoices@example.com",
      "send_estimates_to_attention": null,
      "send_estimates_to_email": "estimates@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:16:03.258Z",
      "updated_at": "2026-09-23T09:16:03.258Z",
      "version": 1790154963,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000002/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "date": "2026-09-23",
    "state": "open",
    "due_date": null,
    "reference": "Invoice 2",
    "entry_number": 102,
    "origin": null,
    "source": null,
    "source_url": null,
    "currency": "EUR",
    "paid_at": null,
    "created_at": "2026-09-23T09:16:03.265Z",
    "updated_at": "2026-09-23T09:16:03.268Z",
    "version": 1790154963,
    "details": [
      {
        "id": "499053957266540382",
        "administration_id": 123,
        "tax_rate_id": "499053794204583050",
        "ledger_account_id": "499053794017936506",
        "project_id": null,
        "product_id": null,
        "amount": "1 x",
        "amount_decimal": "1.0",
        "description": "Invoice detail description",
        "price": "100.0",
        "period": null,
        "row_order": 0,
        "total_price_excl_tax_with_discount": "100.0",
        "total_price_excl_tax_with_discount_base": "100.0",
        "tax_report_reference": [],
        "mandatory_tax_text": null,
        "created_at": "2026-09-23T09:16:03.267Z",
        "updated_at": "2026-09-23T09:16:03.267Z"
      }
    ],
    "payments": [],
    "total_paid": "0.0",
    "total_unpaid": "121.0",
    "total_unpaid_base": "121.0",
    "prices_are_incl_tax": false,
    "total_price_excl_tax": "100.0",
    "total_price_excl_tax_base": "100.0",
    "total_price_incl_tax": "121.0",
    "total_price_incl_tax_base": "121.0",
    "marked_dubious_on": null,
    "marked_uncollectible_on": null,
    "notes": [],
    "attachments": [],
    "events": [],
    "tax_totals": [
      {
        "tax_rate_id": "499053794204583050",
        "taxable_amount": "100.0",
        "taxable_amount_base": "100.0",
        "tax_amount": "21.0",
        "tax_amount_base": "21.0"
      }
    ]
  }
]

json

application/json

Download attachment

GET

https://moneybird.com/api/v2

/{administration_id}/external_sales_invoices/{external_sales_invoice_id}/attachments/{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)

sales_invoices

Download attachment › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

external_sales_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

Download attachment › Responses

Found

string

Delete an attachment

DELETE

https://moneybird.com/api/v2

/{administration_id}/external_sales_invoices/{external_sales_invoice_id}/attachments/{id}{format}

Deletes an attachment of an attachable.

Required scope(s)

sales_invoices

Delete an attachment › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

external_sales_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

Delete an attachment › Responses

Attachment deleted

No data returned

Destroys note from entity

DELETE

https://moneybird.com/api/v2

/{administration_id}/external_sales_invoices/{external_sales_invoice_id}/notes/{id}{format}

Deletes a note from the external sales invoice

Required scope(s)

sales_invoices

Destroys note from entity › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

external_sales_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}/external_sales_invoices/{external_sales_invoice_id}/notes{format}

Adds a note to the external sales invoice.

Required scope(s)

sales_invoices

Adds note to entity › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

external_sales_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}/external_sales_invoices/{external_sales_invoice_id}/notes{format}

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

Example Request Body

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

json

application/json

Example Responses

{
  "id": "499053958088624078",
  "administration_id": 123,
  "entity_id": "499053958061361098",
  "entity_type": "ExternalSalesInvoice",
  "user_id": "499053793376207973",
  "assignee_id": "499053958069749708",
  "todo": true,
  "note": "Text of the note",
  "completed_at": null,
  "completed_by_id": null,
  "todo_type": null,
  "data": {},
  "created_at": "2026-09-23T09:16:04.050Z",
  "updated_at": "2026-09-23T09:16:04.050Z"
}

json

application/json

Delete a payment

DELETE

https://moneybird.com/api/v2

/{administration_id}/external_sales_invoices/{external_sales_invoice_id}/payments/{id}{format}

Deletes a payment from an external sales invoice.

Required scope(s)

sales_invoices

Delete a payment › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

external_sales_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

Delete a payment › Responses

Payment deleted

No data returned

Create a payment

POST

https://moneybird.com/api/v2

/{administration_id}/external_sales_invoices/{external_sales_invoice_id}/payments{format}

Registers a payment for a external sales invoice.

Required scope(s)

sales_invoices

Create a payment › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

external_sales_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

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}/external_sales_invoices/{external_sales_invoice_id}/payments{format}

curl https://moneybird.com/api/v2/:administration_id/external_sales_invoices/:external_sales_invoice_id/payments:format \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "payment": {
    "payment_date": "2026-09-23T09:16:04.123Z",
    "price": "121.0"
  }
}'

Example Request Body

{
  "payment": {
    "payment_date": "2026-09-23T09:16:04.123Z",
    "price": "121.0"
  }
}

json

application/json

Example Responses

{
  "id": "499053958176704472",
  "administration_id": 123,
  "invoice_type": "ExternalSalesInvoice",
  "invoice_id": "499053958159927254",
  "financial_account_id": null,
  "user_id": "499053793376207973",
  "payment_transaction_id": null,
  "transaction_identifier": null,
  "price": "121.0",
  "price_base": "121.0",
  "payment_date": "2026-09-23",
  "credit_invoice_id": null,
  "financial_mutation_id": null,
  "ledger_account_id": "499053794046248067",
  "linked_payment_id": null,
  "manual_payment_action": null,
  "created_at": "2026-09-23T09:16:04.135Z",
  "updated_at": "2026-09-23T09:16:04.135Z"
}

json

application/json

Add attachment to external sales invoice

POST

https://moneybird.com/api/v2

/{administration_id}/external_sales_invoices/{id}/attachment{format}

Add an attachment to an external sales invoice.

Required scope(s)

sales_invoices

Add attachment to external sales 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 external sales invoice › Request Body

file

string · binary

Add attachment to external sales invoice › Responses

Status code

integer

Mark as dubious

PATCH

https://moneybird.com/api/v2

/{administration_id}/external_sales_invoices/{id}/mark_as_dubious{format}

This endpoint marks an external sales invoice as dubious.

Required scope(s)

sales_invoices

Mark as dubious › 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

Mark as dubious › Request Body

dubious_date

string · date

Mark as dubious › Responses

External sales 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

date

string · date

state

string · enum

Enum values:

new

open

late

paid

uncollectible

pending_payment

due_date

string | null · date

reference

string | null

entry_number

integer

origin

string | null · enum

Enum values:

upload

endpoint

si_local

si_peppol

api

moneybird_bv

source

string | null

source_url

string | null

currency

ISO 4217 currency code

paid_at

string | null · date

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

total_paid

string

total_unpaid

string

total_unpaid_base

string

prices_are_incl_tax

boolean

total_price_excl_tax

string

total_price_excl_tax_base

string

total_price_incl_tax

string

total_price_incl_tax_base

string

marked_dubious_on

string | null · date

marked_uncollectible_on

string | null · date

PATCH/{administration_id}/external_sales_invoices/{id}/mark_as_dubious{format}

curl https://moneybird.com/api/v2/:administration_id/external_sales_invoices/:id/mark_as_dubious:format \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{}'

Example Request Body

{}

json

application/json

Example Responses

{
  "id": "499053956592305932",
  "administration_id": 123,
  "contact_id": "499053956579723019",
  "contact": {
    "id": "499053956579723019",
    "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": null,
    "is_trusted": false,
    "max_transfer_amount": null,
    "attention": null,
    "email": "invoices@example.com",
    "email_ubl": false,
    "send_invoices_to_attention": null,
    "send_invoices_to_email": "invoices@example.com",
    "send_estimates_to_attention": null,
    "send_estimates_to_email": "estimates@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:16:02.612Z",
    "updated_at": "2026-09-23T09:16:02.612Z",
    "version": 1790154962,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000001/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "date": "2026-06-25",
  "state": "open",
  "due_date": null,
  "reference": "Invoice 1",
  "entry_number": 101,
  "origin": null,
  "source": null,
  "source_url": null,
  "currency": "EUR",
  "paid_at": null,
  "created_at": "2026-09-23T09:16:02.623Z",
  "updated_at": "2026-09-23T09:16:02.865Z",
  "version": 1790154962,
  "details": [
    {
      "id": "499053956594403085",
      "administration_id": 123,
      "tax_rate_id": "499053794204583050",
      "ledger_account_id": "499053794017936506",
      "project_id": null,
      "product_id": null,
      "amount": "1 x",
      "amount_decimal": "1.0",
      "description": "Invoice detail description",
      "price": "100.0",
      "period": null,
      "row_order": 0,
      "total_price_excl_tax_with_discount": "100.0",
      "total_price_excl_tax_with_discount_base": "100.0",
      "tax_report_reference": [
        "NL/1a"
      ],
      "mandatory_tax_text": null,
      "created_at": "2026-09-23T09:16:02.625Z",
      "updated_at": "2026-09-23T09:16:02.625Z"
    }
  ],
  "payments": [],
  "total_paid": "0.0",
  "total_unpaid": "121.0",
  "total_unpaid_base": "121.0",
  "prices_are_incl_tax": false,
  "total_price_excl_tax": "100.0",
  "total_price_excl_tax_base": "100.0",
  "total_price_incl_tax": "121.0",
  "total_price_incl_tax_base": "121.0",
  "marked_dubious_on": "2026-09-23",
  "marked_uncollectible_on": null,
  "notes": [],
  "attachments": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": "499053793376207973",
      "action": "external_sales_invoice_marked_as_dubious",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-09-23T09:16:02.868Z",
      "updated_at": "2026-09-23T09:16:02.868Z"
    }
  ],
  "tax_totals": [
    {
      "tax_rate_id": "499053794204583050",
      "taxable_amount": "100.0",
      "taxable_amount_base": "100.0",
      "tax_amount": "21.0",
      "tax_amount_base": "21.0"
    }
  ]
}

json

application/json

Mark as uncollectible

PATCH

https://moneybird.com/api/v2

/{administration_id}/external_sales_invoices/{id}/mark_as_uncollectible{format}

This endpoint marks an external sales invoice as uncollectible.

Required scope(s)

sales_invoices

Mark as uncollectible › 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

Mark as uncollectible › Request Body

uncollectible_date

string · date

book_method

string

Can be revenue.

Mark as uncollectible › Responses

External sales 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

date

string · date

state

string · enum

Enum values:

new

open

late

paid

uncollectible

pending_payment

due_date

string | null · date

reference

string | null

entry_number

integer

origin

string | null · enum

Enum values:

upload

endpoint

si_local

si_peppol

api

moneybird_bv

source

string | null

source_url

string | null

currency

ISO 4217 currency code

paid_at

string | null · date

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

total_paid

string

total_unpaid

string

total_unpaid_base

string

prices_are_incl_tax

boolean

total_price_excl_tax

string

total_price_excl_tax_base

string

total_price_incl_tax

string

total_price_incl_tax_base

string

marked_dubious_on

string | null · date

marked_uncollectible_on

string | null · date

PATCH/{administration_id}/external_sales_invoices/{id}/mark_as_uncollectible{format}

curl https://moneybird.com/api/v2/:administration_id/external_sales_invoices/:id/mark_as_uncollectible:format \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{}'

Example Request Body

{}

json

application/json

Example Responses

{
  "id": "499053953453917892",
  "administration_id": 123,
  "contact_id": "499053953444480707",
  "contact": {
    "id": "499053953444480707",
    "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": null,
    "is_trusted": false,
    "max_transfer_amount": null,
    "attention": null,
    "email": "invoices@example.com",
    "email_ubl": false,
    "send_invoices_to_attention": null,
    "send_invoices_to_email": "invoices@example.com",
    "send_estimates_to_attention": null,
    "send_estimates_to_email": "estimates@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.621Z",
    "updated_at": "2026-09-23T09:15:59.621Z",
    "version": 1790154959,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000001/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "date": "2026-06-25",
  "state": "uncollectible",
  "due_date": null,
  "reference": "Invoice 1",
  "entry_number": 101,
  "origin": null,
  "source": null,
  "source_url": null,
  "currency": "EUR",
  "paid_at": null,
  "created_at": "2026-09-23T09:15:59.630Z",
  "updated_at": "2026-09-23T09:15:59.992Z",
  "version": 1790154959,
  "details": [
    {
      "id": "499053953456015045",
      "administration_id": 123,
      "tax_rate_id": "499053794204583050",
      "ledger_account_id": "499053794017936506",
      "project_id": null,
      "product_id": null,
      "amount": "1 x",
      "amount_decimal": "1.0",
      "description": "Invoice detail description",
      "price": "100.0",
      "period": null,
      "row_order": 0,
      "total_price_excl_tax_with_discount": "100.0",
      "total_price_excl_tax_with_discount_base": "100.0",
      "tax_report_reference": [
        "NL/1a"
      ],
      "mandatory_tax_text": null,
      "created_at": "2026-09-23T09:15:59.632Z",
      "updated_at": "2026-09-23T09:15:59.991Z"
    }
  ],
  "payments": [],
  "total_paid": "0.0",
  "total_unpaid": "121.0",
  "total_unpaid_base": "121.0",
  "prices_are_incl_tax": false,
  "total_price_excl_tax": "100.0",
  "total_price_excl_tax_base": "100.0",
  "total_price_incl_tax": "121.0",
  "total_price_incl_tax_base": "121.0",
  "marked_dubious_on": null,
  "marked_uncollectible_on": "2026-09-23",
  "notes": [],
  "attachments": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": "499053793376207973",
      "action": "external_sales_invoice_state_changed_to_uncollectible",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-09-23T09:15:59.979Z",
      "updated_at": "2026-09-23T09:15:59.979Z"
    },
    {
      "administration_id": 123,
      "user_id": "499053793376207973",
      "action": "external_sales_invoice_marked_as_uncollectible",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-09-23T09:15:59.996Z",
      "updated_at": "2026-09-23T09:15:59.996Z"
    }
  ],
  "tax_totals": [
    {
      "tax_rate_id": "499053794204583050",
      "taxable_amount": "100.0",
      "taxable_amount_base": "100.0",
      "tax_amount": "21.0",
      "tax_amount_base": "21.0"
    }
  ]
}

json

application/json

Get an external sales invoice by id

GET

https://moneybird.com/api/v2

/{administration_id}/external_sales_invoices/{id}{format}

Returns an external sales invoice in the administration.

Required scope(s)

sales_invoices

Get an external sales invoice 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 an external sales invoice by id › Responses

An external sales 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

date

string · date

state

string · enum

Enum values:

new

open

late

paid

uncollectible

pending_payment

due_date

string | null · date

reference

string | null

entry_number

integer

origin

string | null · enum

Enum values:

upload

endpoint

si_local

si_peppol

api

moneybird_bv

source

string | null

source_url

string | null

currency

ISO 4217 currency code

paid_at

string | null · date

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

total_paid

string

total_unpaid

string

total_unpaid_base

string

prices_are_incl_tax

boolean

total_price_excl_tax

string

total_price_excl_tax_base

string

total_price_incl_tax

string

total_price_incl_tax_base

string

marked_dubious_on

string | null · date

marked_uncollectible_on

string | null · date

GET/{administration_id}/external_sales_invoices/{id}{format}

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

Example Responses

{
  "id": "499053953254688429",
  "administration_id": 123,
  "contact_id": "499053953246299820",
  "contact": {
    "id": "499053953246299820",
    "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": null,
    "is_trusted": false,
    "max_transfer_amount": null,
    "attention": null,
    "email": "invoices@example.com",
    "email_ubl": false,
    "send_invoices_to_attention": null,
    "send_invoices_to_email": "invoices@example.com",
    "send_estimates_to_attention": null,
    "send_estimates_to_email": "estimates@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.432Z",
    "updated_at": "2026-09-23T09:15:59.432Z",
    "version": 1790154959,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000001/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "date": "2026-09-23",
  "state": "open",
  "due_date": null,
  "reference": "Invoice 1",
  "entry_number": 101,
  "origin": null,
  "source": null,
  "source_url": null,
  "currency": "EUR",
  "paid_at": null,
  "created_at": "2026-09-23T09:15:59.440Z",
  "updated_at": "2026-09-23T09:15:59.443Z",
  "version": 1790154959,
  "details": [
    {
      "id": "499053953255737006",
      "administration_id": 123,
      "tax_rate_id": "499053794204583050",
      "ledger_account_id": "499053794017936506",
      "project_id": null,
      "product_id": null,
      "amount": "1 x",
      "amount_decimal": "1.0",
      "description": "Invoice detail description",
      "price": "100.0",
      "period": null,
      "row_order": 0,
      "total_price_excl_tax_with_discount": "100.0",
      "total_price_excl_tax_with_discount_base": "100.0",
      "tax_report_reference": [],
      "mandatory_tax_text": null,
      "created_at": "2026-09-23T09:15:59.442Z",
      "updated_at": "2026-09-23T09:15:59.442Z"
    }
  ],
  "payments": [],
  "total_paid": "0.0",
  "total_unpaid": "121.0",
  "total_unpaid_base": "121.0",
  "prices_are_incl_tax": false,
  "total_price_excl_tax": "100.0",
  "total_price_excl_tax_base": "100.0",
  "total_price_incl_tax": "121.0",
  "total_price_incl_tax_base": "121.0",
  "marked_dubious_on": null,
  "marked_uncollectible_on": null,
  "notes": [],
  "attachments": [],
  "events": [],
  "tax_totals": [
    {
      "tax_rate_id": "499053794204583050",
      "taxable_amount": "100.0",
      "taxable_amount_base": "100.0",
      "tax_amount": "21.0",
      "tax_amount_base": "21.0"
    }
  ]
}

json

application/json

Delete an external sales invoice

DELETE

https://moneybird.com/api/v2

/{administration_id}/external_sales_invoices/{id}{format}

Deletes an external sales invoice.

Required scope(s)

sales_invoices

Delete an external sales 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

Delete an external sales invoice › Responses

External sales invoice deleted

No data returned

Update an external sales invoice

PATCH

https://moneybird.com/api/v2

/{administration_id}/external_sales_invoices/{id}{format}

When updating an external sales invoice, provide only the attributes you want to update. The other attributes will not be changed.

Required scope(s)

sales_invoices

Update an external sales 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 an external sales invoice › Request Body

object

Update an external sales invoice › Responses

External sales 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

date

string · date

state

string · enum

Enum values:

new

open

late

paid

uncollectible

pending_payment

due_date

string | null · date

reference

string | null

entry_number

integer

origin

string | null · enum

Enum values:

upload

endpoint

si_local

si_peppol

api

moneybird_bv

source

string | null

source_url

string | null

currency

ISO 4217 currency code

paid_at

string | null · date

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

total_paid

string

total_unpaid

string

total_unpaid_base

string

prices_are_incl_tax

boolean

total_price_excl_tax

string

total_price_excl_tax_base

string

total_price_incl_tax

string

total_price_incl_tax_base

string

marked_dubious_on

string | null · date

marked_uncollectible_on

string | null · date

external_sales_invoice_response[]

PATCH/{administration_id}/external_sales_invoices/{id}{format}

curl https://moneybird.com/api/v2/:administration_id/external_sales_invoices/:id:format \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "external_sales_invoice": {
    "details_attributes": [
      {
        "description": "Sofa",
        "price": 199.99
      },
      {
        "id": 499053959658341500,
        "_destroy": true
      }
    ]
  }
}'

Example Request Body

{
  "external_sales_invoice": {
    "details_attributes": [
      {
        "description": "Sofa",
        "price": 199.99
      },
      {
        "id": 499053959658341500,
        "_destroy": true
      }
    ]
  }
}

json

application/json

Example Responses

{
  "id": "499053959656244334",
  "administration_id": 123,
  "contact_id": "499053959647855725",
  "contact": {
    "id": "499053959647855725",
    "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": null,
    "is_trusted": false,
    "max_transfer_amount": null,
    "attention": null,
    "email": "invoices@example.com",
    "email_ubl": false,
    "send_invoices_to_attention": null,
    "send_invoices_to_email": "invoices@example.com",
    "send_estimates_to_attention": null,
    "send_estimates_to_email": "estimates@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:16:05.538Z",
    "updated_at": "2026-09-23T09:16:05.538Z",
    "version": 1790154965,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000001/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "date": "2026-09-23",
  "state": "open",
  "due_date": null,
  "reference": "Invoice 1",
  "entry_number": 1,
  "origin": null,
  "source": null,
  "source_url": null,
  "currency": "EUR",
  "paid_at": null,
  "created_at": "2026-09-23T09:16:05.545Z",
  "updated_at": "2026-09-23T09:16:05.633Z",
  "version": 1790154965,
  "details": [
    {
      "id": "499053959746421873",
      "administration_id": 123,
      "tax_rate_id": "499053794204583050",
      "ledger_account_id": "499053794017936506",
      "project_id": null,
      "product_id": null,
      "amount": null,
      "amount_decimal": "1.0",
      "description": "Sofa",
      "price": "199.99",
      "period": null,
      "row_order": 0,
      "total_price_excl_tax_with_discount": "199.99",
      "total_price_excl_tax_with_discount_base": "199.99",
      "tax_report_reference": [
        "NL/1a"
      ],
      "mandatory_tax_text": null,
      "created_at": "2026-09-23T09:16:05.632Z",
      "updated_at": "2026-09-23T09:16:05.632Z"
    }
  ],
  "payments": [],
  "total_paid": "0.0",
  "total_unpaid": "241.99",
  "total_unpaid_base": "241.99",
  "prices_are_incl_tax": false,
  "total_price_excl_tax": "199.99",
  "total_price_excl_tax_base": "199.99",
  "total_price_incl_tax": "241.99",
  "total_price_incl_tax_base": "241.99",
  "marked_dubious_on": null,
  "marked_uncollectible_on": null,
  "notes": [],
  "attachments": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": "499053793376207973",
      "action": "external_sales_invoice_updated",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-09-23T09:16:05.635Z",
      "updated_at": "2026-09-23T09:16:05.635Z"
    }
  ],
  "tax_totals": [
    {
      "tax_rate_id": "499053794204583050",
      "taxable_amount": "199.99",
      "taxable_amount_base": "199.99",
      "tax_amount": "42.0",
      "tax_amount_base": "42.0"
    }
  ]
}

json

application/json

List all external invoices

GET

https://moneybird.com/api/v2

/{administration_id}/external_sales_invoices{format}

Returns a paginated list of external sales invoices in the administration.

Required scope(s)

sales_invoices

List all external 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

List all external invoices › query Parameters

filter

string

Filter	Type	Default	Description
state	`String`	`all`	`all`, `new`, `open`, `late`, or `paid`
period	`String`	`this_year`	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`)
contact_id	`Integer`		Select invoices belonging to a certain contact

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

Default: period:this_year

page

integer | string

per_page

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

List all external invoices › Responses

A list of external sales 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

date

string · date

state

string · enum

Enum values:

new

open

late

paid

uncollectible

pending_payment

due_date

string | null · date

reference

string | null

entry_number

integer

origin

string | null · enum

Enum values:

upload

endpoint

si_local

si_peppol

api

moneybird_bv

source

string | null

source_url

string | null

currency

ISO 4217 currency code

paid_at

string | null · date

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

total_paid

string

total_unpaid

string

total_unpaid_base

string

prices_are_incl_tax

boolean

total_price_excl_tax

string

total_price_excl_tax_base

string

total_price_incl_tax

string

total_price_incl_tax_base

string

marked_dubious_on

string | null · date

marked_uncollectible_on

string | null · date

GET/{administration_id}/external_sales_invoices{format}

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

Example Responses

[
  {
    "id": "499053958618155003",
    "administration_id": 123,
    "contact_id": "499053958609766394",
    "contact": {
      "id": "499053958609766394",
      "administration_id": 123,
      "company_name": "Relation 3",
      "firstname": null,
      "lastname": null,
      "address1": null,
      "address2": null,
      "zipcode": null,
      "city": null,
      "country": "NL",
      "phone": null,
      "delivery_method": "Email",
      "customer_id": "customer-3",
      "tax_number": null,
      "chamber_of_commerce": null,
      "bank_account": null,
      "is_trusted": false,
      "max_transfer_amount": null,
      "attention": null,
      "email": "invoices@example.com",
      "email_ubl": false,
      "send_invoices_to_attention": null,
      "send_invoices_to_email": "invoices@example.com",
      "send_estimates_to_attention": null,
      "send_estimates_to_email": "estimates@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:16:04.548Z",
      "updated_at": "2026-09-23T09:16:04.548Z",
      "version": 1790154964,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000003/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "date": "2026-09-23",
    "state": "open",
    "due_date": null,
    "reference": "Invoice 3",
    "entry_number": 103,
    "origin": null,
    "source": null,
    "source_url": null,
    "currency": "EUR",
    "paid_at": null,
    "created_at": "2026-09-23T09:16:04.555Z",
    "updated_at": "2026-09-23T09:16:04.558Z",
    "version": 1790154964,
    "details": [
      {
        "id": "499053958619203580",
        "administration_id": 123,
        "tax_rate_id": "499053794204583050",
        "ledger_account_id": "499053794017936506",
        "project_id": null,
        "product_id": null,
        "amount": "1 x",
        "amount_decimal": "1.0",
        "description": "Invoice detail description",
        "price": "100.0",
        "period": null,
        "row_order": 0,
        "total_price_excl_tax_with_discount": "100.0",
        "total_price_excl_tax_with_discount_base": "100.0",
        "tax_report_reference": [],
        "mandatory_tax_text": null,
        "created_at": "2026-09-23T09:16:04.556Z",
        "updated_at": "2026-09-23T09:16:04.556Z"
      }
    ],
    "payments": [],
    "total_paid": "0.0",
    "total_unpaid": "121.0",
    "total_unpaid_base": "121.0",
    "prices_are_incl_tax": false,
    "total_price_excl_tax": "100.0",
    "total_price_excl_tax_base": "100.0",
    "total_price_incl_tax": "121.0",
    "total_price_incl_tax_base": "121.0",
    "marked_dubious_on": null,
    "marked_uncollectible_on": null,
    "notes": [],
    "attachments": [],
    "events": [],
    "tax_totals": [
      {
        "tax_rate_id": "499053794204583050",
        "taxable_amount": "100.0",
        "taxable_amount_base": "100.0",
        "tax_amount": "21.0",
        "tax_amount_base": "21.0"
      }
    ]
  },
  {
    "id": "499053958602426359",
    "administration_id": 123,
    "contact_id": "499053958595086326",
    "contact": {
      "id": "499053958595086326",
      "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": null,
      "is_trusted": false,
      "max_transfer_amount": null,
      "attention": null,
      "email": "invoices@example.com",
      "email_ubl": false,
      "send_invoices_to_attention": null,
      "send_invoices_to_email": "invoices@example.com",
      "send_estimates_to_attention": null,
      "send_estimates_to_email": "estimates@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:16:04.533Z",
      "updated_at": "2026-09-23T09:16:04.533Z",
      "version": 1790154964,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000002/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "date": "2026-09-23",
    "state": "open",
    "due_date": null,
    "reference": "Invoice 2",
    "entry_number": 102,
    "origin": null,
    "source": null,
    "source_url": null,
    "currency": "EUR",
    "paid_at": null,
    "created_at": "2026-09-23T09:16:04.540Z",
    "updated_at": "2026-09-23T09:16:04.543Z",
    "version": 1790154964,
    "details": [
      {
        "id": "499053958603474936",
        "administration_id": 123,
        "tax_rate_id": "499053794204583050",
        "ledger_account_id": "499053794017936506",
        "project_id": null,
        "product_id": null,
        "amount": "1 x",
        "amount_decimal": "1.0",
        "description": "Invoice detail description",
        "price": "100.0",
        "period": null,
        "row_order": 0,
        "total_price_excl_tax_with_discount": "100.0",
        "total_price_excl_tax_with_discount_base": "100.0",
        "tax_report_reference": [],
        "mandatory_tax_text": null,
        "created_at": "2026-09-23T09:16:04.541Z",
        "updated_at": "2026-09-23T09:16:04.541Z"
      }
    ],
    "payments": [],
    "total_paid": "0.0",
    "total_unpaid": "121.0",
    "total_unpaid_base": "121.0",
    "prices_are_incl_tax": false,
    "total_price_excl_tax": "100.0",
    "total_price_excl_tax_base": "100.0",
    "total_price_incl_tax": "121.0",
    "total_price_incl_tax_base": "121.0",
    "marked_dubious_on": null,
    "marked_uncollectible_on": null,
    "notes": [],
    "attachments": [],
    "events": [],
    "tax_totals": [
      {
        "tax_rate_id": "499053794204583050",
        "taxable_amount": "100.0",
        "taxable_amount_base": "100.0",
        "tax_amount": "21.0",
        "tax_amount_base": "21.0"
      }
    ]
  },
  {
    "id": "499053958585649139",
    "administration_id": 123,
    "contact_id": "499053958578309106",
    "contact": {
      "id": "499053958578309106",
      "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": null,
      "is_trusted": false,
      "max_transfer_amount": null,
      "attention": null,
      "email": "invoices@example.com",
      "email_ubl": false,
      "send_invoices_to_attention": null,
      "send_invoices_to_email": "invoices@example.com",
      "send_estimates_to_attention": null,
      "send_estimates_to_email": "estimates@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:16:04.517Z",
      "updated_at": "2026-09-23T09:16:04.517Z",
      "version": 1790154964,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000001/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "date": "2026-09-23",
    "state": "open",
    "due_date": null,
    "reference": "Invoice 1",
    "entry_number": 101,
    "origin": null,
    "source": null,
    "source_url": null,
    "currency": "EUR",
    "paid_at": null,
    "created_at": "2026-09-23T09:16:04.525Z",
    "updated_at": "2026-09-23T09:16:04.528Z",
    "version": 1790154964,
    "details": [
      {
        "id": "499053958587746292",
        "administration_id": 123,
        "tax_rate_id": "499053794204583050",
        "ledger_account_id": "499053794017936506",
        "project_id": null,
        "product_id": null,
        "amount": "1 x",
        "amount_decimal": "1.0",
        "description": "Invoice detail description",
        "price": "100.0",
        "period": null,
        "row_order": 0,
        "total_price_excl_tax_with_discount": "100.0",
        "total_price_excl_tax_with_discount_base": "100.0",
        "tax_report_reference": [],
        "mandatory_tax_text": null,
        "created_at": "2026-09-23T09:16:04.526Z",
        "updated_at": "2026-09-23T09:16:04.526Z"
      }
    ],
    "payments": [],
    "total_paid": "0.0",
    "total_unpaid": "121.0",
    "total_unpaid_base": "121.0",
    "prices_are_incl_tax": false,
    "total_price_excl_tax": "100.0",
    "total_price_excl_tax_base": "100.0",
    "total_price_incl_tax": "121.0",
    "total_price_incl_tax_base": "121.0",
    "marked_dubious_on": null,
    "marked_uncollectible_on": null,
    "notes": [],
    "attachments": [],
    "events": [],
    "tax_totals": [
      {
        "tax_rate_id": "499053794204583050",
        "taxable_amount": "100.0",
        "taxable_amount_base": "100.0",
        "tax_amount": "21.0",
        "tax_amount_base": "21.0"
      }
    ]
  }
]

json

application/json

Create an external sales invoice

POST

https://moneybird.com/api/v2

/{administration_id}/external_sales_invoices{format}

Creates a new external sales invoice.

Required scope(s)

sales_invoices

Create an external sales 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 an external sales invoice › Request Body

object

Create an external sales invoice › Responses

External sales 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

date

string · date

state

string · enum

Enum values:

new

open

late

paid

uncollectible

pending_payment

due_date

string | null · date

reference

string | null

entry_number

integer

origin

string | null · enum

Enum values:

upload

endpoint

si_local

si_peppol

api

moneybird_bv

source

string | null

source_url

string | null

currency

ISO 4217 currency code

paid_at

string | null · date

created_at

timestamp · date-time

updated_at

timestamp · date-time

version

total_paid

string

total_unpaid

string

total_unpaid_base

string

prices_are_incl_tax

boolean

total_price_excl_tax

string

total_price_excl_tax_base

string

total_price_incl_tax

string

total_price_incl_tax_base

string

marked_dubious_on

string | null · date

marked_uncollectible_on

string | null · date