External sales invoices

Endpointhttps://moneybird.com/api/v2

External sales invoices are invoices created in other systems that you want to import into Moneybird for a complete overview of your revenue.

Create external sales invoice from attachment

POST

https://moneybird.com/api/v2

/{administration_id}/external_sales_invoices/attachment{format}

Creates an external sales invoice from an attachment.

Create external sales invoice from attachment › path Parameters

administration_id

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

The unique identifier of the administration

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Create external sales invoice from attachment › Request Body

file

string · binary

Create external sales invoice from attachment › Responses

Status code

integer

List all ids and versions

GET

https://moneybird.com/api/v2

/{administration_id}/external_sales_invoices/synchronization{format}

Returns all external sales invoices in the administration. The list contains the id and the version of the external sales invoice. Check if the version of an external sales invoice is newer than the version you have stored locally, use the POST variant for fetching external sales invoices with the given ids.

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

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_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.

List all ids and versions › path Parameters

administration_id

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

The unique identifier of the administration

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

List all ids and versions › query Parameters

filter

string

List all ids and versions › Responses

200

IDs and versions of records

object[]

id

integer | string

version

integer | string

Fetch external sales invoices with given ids

POST

https://moneybird.com/api/v2

/{administration_id}/external_sales_invoices/synchronization{format}

Given a list of external sales invoice ids, returns the external sales invoice information belonging to the external sales invoice. Returns a maximum of 100 external sales invoices, even if more ids are provided.

Fetch external sales invoices with given ids › path Parameters

administration_id

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

The unique identifier of the administration

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Fetch external sales invoices with given ids › Request Body

ids

(integer | string)[] · required

Fetch external sales invoices with given ids › Responses

A list of external sales invoices

object[]

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

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

string

ISO 4217 currency code

paid_at

string | null · date

created_at

string · date-time

updated_at

string · date-time

version

integer

object[]

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

object[]

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

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/external_sales_invoices/synchronization:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "ids": [
    481770604726322300,
    481770604747293800
  ]
}
'

shell

Example Request Body

{
  "ids": [
    481770604726322300,
    481770604747293800
  ]
}

json

application/json

Example Responses

[
  {
    "id": "481770604747293830",
    "administration_id": 123,
    "contact_id": "481770604736808068",
    "contact": {
      "id": "481770604736808068",
      "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-03-16T14:44:33.857Z",
      "updated_at": "2026-03-16T14:44:33.857Z",
      "version": 1773672273,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000003/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "date": "2026-03-16",
    "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-03-16T14:44:33.867Z",
    "updated_at": "2026-03-16T14:44:33.871Z",
    "version": 1773672273,
    "details": [
      {
        "id": "481770604749390983",
        "administration_id": 123,
        "tax_rate_id": "481770604732613762",
        "ledger_account_id": "481770604741002373",
        "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-03-16T14:44:33.869Z",
        "updated_at": "2026-03-16T14:44:33.869Z"
      }
    ],
    "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": "481770604732613762",
        "taxable_amount": "100.0",
        "taxable_amount_base": "100.0",
        "tax_amount": "21.0",
        "tax_amount_base": "21.0"
      }
    ]
  },
  {
    "id": "481770604726322304",
    "administration_id": 123,
    "contact_id": "481770604715836542",
    "contact": {
      "id": "481770604715836542",
      "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-03-16T14:44:33.838Z",
      "updated_at": "2026-03-16T14:44:33.838Z",
      "version": 1773672273,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000002/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "date": "2026-03-16",
    "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-03-16T14:44:33.848Z",
    "updated_at": "2026-03-16T14:44:33.851Z",
    "version": 1773672273,
    "details": [
      {
        "id": "481770604728419457",
        "administration_id": 123,
        "tax_rate_id": "481770604712690812",
        "ledger_account_id": "481770604720030847",
        "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-03-16T14:44:33.849Z",
        "updated_at": "2026-03-16T14:44:33.849Z"
      }
    ],
    "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": "481770604712690812",
        "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.

Download attachment › path Parameters

administration_id

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

The unique identifier of the administration

A unique record identifier

external_sales_invoice_id

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

A unique record identifier

id

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

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

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.

Delete an attachment › path Parameters

administration_id

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

The unique identifier of the administration

A unique record identifier

external_sales_invoice_id

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

A unique record identifier

id

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

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Delete 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

Destroys note from entity › path Parameters

administration_id

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

The unique identifier of the administration

A unique record identifier

external_sales_invoice_id

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

A unique record identifier

id

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

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

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.

Adds note to entity › path Parameters

administration_id

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

The unique identifier of the administration

A unique record identifier

external_sales_invoice_id

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

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Adds note to entity › Request Body

object

Adds note to entity › Responses

Note created

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

entity_id

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

A unique record identifier

entity_type

string

user_id

string | integer · pattern: ^\d+$

A unique record identifier

assignee_id

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

A unique record identifier

todo

boolean | string | null

Default: false

note

string | null

completed_at

string | null · date-time

completed_by_id

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

string · date-time

updated_at

string · date-time

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

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

shell

Example Request Body

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

json

application/json

Example Responses

{
  "id": "481770611963594474",
  "administration_id": 123,
  "entity_id": "481770611930040038",
  "entity_type": "ExternalSalesInvoice",
  "user_id": 17736721351849,
  "assignee_id": "481770611940525800",
  "todo": true,
  "note": "Text of the note",
  "completed_at": null,
  "completed_by_id": null,
  "todo_type": null,
  "data": {},
  "created_at": "2026-03-16T14:44:40.749Z",
  "updated_at": "2026-03-16T14:44:40.749Z"
}

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.

Delete a payment › path Parameters

administration_id

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

The unique identifier of the administration

A unique record identifier

external_sales_invoice_id

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

A unique record identifier

id

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

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Delete a 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.

Create a payment › path Parameters

administration_id

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

The unique identifier of the administration

A unique record identifier

external_sales_invoice_id

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

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Create a payment › Request Body

object

Create a payment › Responses

Payment created

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

invoice_type

string · enum

Enum values:

SalesInvoice

Document

ExternalSalesInvoice

VatDocument

invoice_id

string | integer · pattern: ^\d+$

A unique record identifier

financial_account_id

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

A unique record identifier

user_id

string | integer · pattern: ^\d+$

A unique record identifier

payment_transaction_id

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

A unique record identifier

transaction_identifier

string | null

payment_date

string · date

credit_invoice_id

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

A unique record identifier

financial_mutation_id

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

A unique record identifier

ledger_account_id

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

A unique record identifier

linked_payment_id

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

A unique record identifier

manual_payment_action

string | null

created_at

string · date-time

updated_at

string · date-time

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

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/external_sales_invoices/:external_sales_invoice_id/payments:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "payment": {
    "payment_date": "2026-03-16T14:44:35.400Z",
    "price": "121.0"
  }
}
'

shell

Example Request Body

{
  "payment": {
    "payment_date": "2026-03-16T14:44:35.400Z",
    "price": "121.0"
  }
}

json

application/json

Example Responses

{
  "id": "481770606371538253",
  "administration_id": 123,
  "invoice_type": "ExternalSalesInvoice",
  "invoice_id": "481770606348469579",
  "financial_account_id": null,
  "user_id": 17736721351849,
  "payment_transaction_id": null,
  "transaction_identifier": null,
  "price": "121.0",
  "price_base": "121.0",
  "payment_date": "2026-03-16",
  "credit_invoice_id": null,
  "financial_mutation_id": null,
  "ledger_account_id": "481770460333212802",
  "linked_payment_id": null,
  "manual_payment_action": null,
  "created_at": "2026-03-16T14:44:35.416Z",
  "updated_at": "2026-03-16T14:44:35.416Z"
}

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.

Add attachment to external sales invoice › path Parameters

administration_id

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

The unique identifier of the administration

A unique record identifier

id

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

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

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.

Mark as dubious › path Parameters

administration_id

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

The unique identifier of the administration

A unique record identifier

id

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

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Mark as dubious › Request Body

dubious_date

string · date

Mark as dubious › Responses

External sales invoice updated

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

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

string

ISO 4217 currency code

paid_at

string | null · date

created_at

string · date-time

updated_at

string · date-time

version

integer

object[]

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

object[]

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

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

shell

Example Request Body

{}

json

application/json

Example Responses

{
  "id": "481770611380586160",
  "administration_id": 123,
  "contact_id": "481770611363808942",
  "contact": {
    "id": "481770611363808942",
    "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-03-16T14:44:40.177Z",
    "updated_at": "2026-03-16T14:44:40.177Z",
    "version": 1773672280,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000001/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "date": "2025-12-16",
  "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-03-16T14:44:40.193Z",
  "updated_at": "2026-03-16T14:44:40.446Z",
  "version": 1773672280,
  "details": [
    {
      "id": "481770611382683313",
      "administration_id": 123,
      "tax_rate_id": "481770611358566060",
      "ledger_account_id": "481770611369051823",
      "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-03-16T14:44:40.195Z",
      "updated_at": "2026-03-16T14:44:40.195Z"
    }
  ],
  "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-03-16",
  "marked_uncollectible_on": null,
  "notes": [],
  "attachments": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": 17736721351849,
      "action": "external_sales_invoice_marked_as_dubious",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-03-16T14:44:40.450Z",
      "updated_at": "2026-03-16T14:44:40.450Z"
    }
  ],
  "tax_totals": [
    {
      "tax_rate_id": "481770611358566060",
      "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.

Mark as uncollectible › path Parameters

administration_id

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

The unique identifier of the administration

A unique record identifier

id

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

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Mark as uncollectible › Request Body

uncollectible_date

string · date

book_method

string

Can be revenue.

Mark as uncollectible › Responses

External sales invoice updated

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

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

string

ISO 4217 currency code

paid_at

string | null · date

created_at

string · date-time

updated_at

string · date-time

version

integer

object[]

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

object[]

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

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

shell

Example Request Body

{}

json

application/json

Example Responses

{
  "id": "481770608498050654",
  "administration_id": 123,
  "contact_id": "481770608483370588",
  "contact": {
    "id": "481770608483370588",
    "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-03-16T14:44:37.431Z",
    "updated_at": "2026-03-16T14:44:37.431Z",
    "version": 1773672277,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000001/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "date": "2025-12-16",
  "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-03-16T14:44:37.444Z",
  "updated_at": "2026-03-16T14:44:37.979Z",
  "version": 1773672277,
  "details": [
    {
      "id": "481770608500147807",
      "administration_id": 123,
      "tax_rate_id": "481770608479176282",
      "ledger_account_id": "481770608488613469",
      "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-03-16T14:44:37.446Z",
      "updated_at": "2026-03-16T14:44:37.977Z"
    }
  ],
  "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-03-16",
  "notes": [],
  "attachments": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": 17736721351849,
      "action": "external_sales_invoice_state_changed_to_uncollectible",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-03-16T14:44:37.960Z",
      "updated_at": "2026-03-16T14:44:37.960Z"
    },
    {
      "administration_id": 123,
      "user_id": 17736721351849,
      "action": "external_sales_invoice_marked_as_uncollectible",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-03-16T14:44:37.983Z",
      "updated_at": "2026-03-16T14:44:37.983Z"
    }
  ],
  "tax_totals": [
    {
      "tax_rate_id": "481770608479176282",
      "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.

Get an external sales invoice by id › path Parameters

administration_id

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

The unique identifier of the administration

A unique record identifier

id

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

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Get an external sales invoice by id › Responses

An external sales invoice

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

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

string

ISO 4217 currency code

paid_at

string | null · date

created_at

string · date-time

updated_at

string · date-time

version

integer

object[]

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

object[]

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

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

shell

Example Responses

{
  "id": "481770606239417663",
  "administration_id": 123,
  "contact_id": "481770606226834749",
  "contact": {
    "id": "481770606226834749",
    "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-03-16T14:44:35.278Z",
    "updated_at": "2026-03-16T14:44:35.278Z",
    "version": 1773672275,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000001/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "date": "2026-03-16",
  "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-03-16T14:44:35.290Z",
  "updated_at": "2026-03-16T14:44:35.293Z",
  "version": 1773672275,
  "details": [
    {
      "id": "481770606240466240",
      "administration_id": 123,
      "tax_rate_id": "481770606221591867",
      "ledger_account_id": "481770606231029054",
      "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-03-16T14:44:35.292Z",
      "updated_at": "2026-03-16T14:44:35.292Z"
    }
  ],
  "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": "481770606221591867",
      "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.

Delete an external sales invoice › path Parameters

administration_id

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

The unique identifier of the administration

A unique record identifier

id

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

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Delete 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.

Update an external sales invoice › path Parameters

administration_id

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

The unique identifier of the administration

A unique record identifier

id

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

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Update an external sales invoice › Request Body

object

Update an external sales invoice › Responses

External sales invoice updated

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

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

string

ISO 4217 currency code

paid_at

string | null · date

created_at

string · date-time

updated_at

string · date-time

version

integer

object[]

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

object[]

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

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

shell

Example Request Body

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

json

application/json

Example Responses

{
  "id": "481770605321913580",
  "administration_id": 123,
  "contact_id": "481770605310379242",
  "contact": {
    "id": "481770605310379242",
    "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-03-16T14:44:34.404Z",
    "updated_at": "2026-03-16T14:44:34.404Z",
    "version": 1773672274,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000001/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "date": "2026-03-16",
  "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-03-16T14:44:34.415Z",
  "updated_at": "2026-03-16T14:44:34.509Z",
  "version": 1773672274,
  "details": [
    {
      "id": "481770605418382575",
      "administration_id": 123,
      "tax_rate_id": "481770605306184936",
      "ledger_account_id": "481770460280783993",
      "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-03-16T14:44:34.507Z",
      "updated_at": "2026-03-16T14:44:34.507Z"
    }
  ],
  "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": 17736721351849,
      "action": "external_sales_invoice_updated",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-03-16T14:44:34.510Z",
      "updated_at": "2026-03-16T14:44:34.510Z"
    }
  ],
  "tax_totals": [
    {
      "tax_rate_id": "481770605306184936",
      "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 all external sales invoices in the administration.

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_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.

List all external invoices › path Parameters

administration_id

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

The unique identifier of the administration

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

List all external invoices › query Parameters

filter

string

page

integer | string

per_page

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

List all external invoices › Responses

A list of external sales invoices

object[]

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

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

string

ISO 4217 currency code

paid_at

string | null · date

created_at

string · date-time

updated_at

string · date-time

version

integer

object[]

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

object[]

GET/{administration_id}/external_sales_invoices{format}

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

shell

Example Responses

[
  {
    "id": "481770607036335547",
    "administration_id": 123,
    "contact_id": "481770607025849785",
    "contact": {
      "id": "481770607025849785",
      "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-03-16T14:44:36.040Z",
      "updated_at": "2026-03-16T14:44:36.040Z",
      "version": 1773672276,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000003/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "date": "2026-03-16",
    "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-03-16T14:44:36.051Z",
    "updated_at": "2026-03-16T14:44:36.054Z",
    "version": 1773672276,
    "details": [
      {
        "id": "481770607038432700",
        "administration_id": 123,
        "tax_rate_id": "481770607020606903",
        "ledger_account_id": "481770607030044090",
        "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-03-16T14:44:36.052Z",
        "updated_at": "2026-03-16T14:44:36.052Z"
      }
    ],
    "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": "481770607020606903",
        "taxable_amount": "100.0",
        "taxable_amount_base": "100.0",
        "tax_amount": "21.0",
        "tax_amount_base": "21.0"
      }
    ]
  },
  {
    "id": "481770607014315445",
    "administration_id": 123,
    "contact_id": "481770607002781107",
    "contact": {
      "id": "481770607002781107",
      "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-03-16T14:44:36.018Z",
      "updated_at": "2026-03-16T14:44:36.018Z",
      "version": 1773672276,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000002/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "date": "2026-03-16",
    "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-03-16T14:44:36.030Z",
    "updated_at": "2026-03-16T14:44:36.033Z",
    "version": 1773672276,
    "details": [
      {
        "id": "481770607016412598",
        "administration_id": 123,
        "tax_rate_id": "481770606998586801",
        "ledger_account_id": "481770607008023988",
        "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-03-16T14:44:36.031Z",
        "updated_at": "2026-03-16T14:44:36.031Z"
      }
    ],
    "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": "481770606998586801",
        "taxable_amount": "100.0",
        "taxable_amount_base": "100.0",
        "tax_amount": "21.0",
        "tax_amount_base": "21.0"
      }
    ]
  },
  {
    "id": "481770606991246767",
    "administration_id": 123,
    "contact_id": "481770606978663853",
    "contact": {
      "id": "481770606978663853",
      "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-03-16T14:44:35.995Z",
      "updated_at": "2026-03-16T14:44:35.995Z",
      "version": 1773672275,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000001/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "date": "2026-03-16",
    "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-03-16T14:44:36.008Z",
    "updated_at": "2026-03-16T14:44:36.011Z",
    "version": 1773672276,
    "details": [
      {
        "id": "481770606993343920",
        "administration_id": 123,
        "tax_rate_id": "481770606974469547",
        "ledger_account_id": "481770606983906734",
        "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-03-16T14:44:36.010Z",
        "updated_at": "2026-03-16T14:44:36.010Z"
      }
    ],
    "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": "481770606974469547",
        "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.

Create an external sales invoice › path Parameters

administration_id

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

The unique identifier of the administration

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Create an external sales invoice › Request Body

object

Create an external sales invoice › Responses

External sales invoice created

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

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

string

ISO 4217 currency code

paid_at

string | null · date

created_at

string · date-time

updated_at

string · date-time

version

integer

object[]

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

object[]

POST/{administration_id}/external_sales_invoices{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/external_sales_invoices:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "external_sales_invoice": {
    "reference": "30052",
    "contact_id": 481770606651508100,
    "details_attributes": [
      {
        "description": "Rocking Chair",
        "price": 129.95
      }
    ]
  }
}
'

shell

Example Request Body

{
  "external_sales_invoice": {
    "reference": "30052",
    "contact_id": 481770606651508100,
    "details_attributes": [
      {
        "description": "Rocking Chair",
        "price": 129.95
      }
    ]
  }
}

json

application/json

Example Responses

{
  "id": "481770606679819642",
  "administration_id": 123,
  "contact_id": "481770606651508088",
  "contact": {
    "id": "481770606651508088",
    "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": "BE0123456789",
    "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": "2026-03-16T14:44:35.681Z",
    "tax_number_valid": true,
    "invoice_workflow_id": null,
    "estimate_workflow_id": null,
    "si_identifier": null,
    "si_identifier_type": null,
    "moneybird_payments_mandate": false,
    "created_at": "2026-03-16T14:44:35.683Z",
    "updated_at": "2026-03-16T14:44:35.683Z",
    "version": 1773672275,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000002/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "date": "2026-03-16",
  "state": "open",
  "due_date": null,
  "reference": "30052",
  "entry_number": 1,
  "origin": "api",
  "source": null,
  "source_url": null,
  "currency": "EUR",
  "paid_at": null,
  "created_at": "2026-03-16T14:44:35.710Z",
  "updated_at": "2026-03-16T14:44:35.714Z",
  "version": 1773672275,
  "details": [
    {
      "id": "481770606681916795",
      "administration_id": 123,
      "tax_rate_id": "481770606626342257",
      "ledger_account_id": "481770460280783993",
      "project_id": null,
      "product_id": null,
      "amount": null,
      "amount_decimal": "1.0",
      "description": "Rocking Chair",
      "price": "129.95",
      "period": null,
      "row_order": 0,
      "total_price_excl_tax_with_discount": "129.95",
      "total_price_excl_tax_with_discount_base": "129.95",
      "tax_report_reference": [
        "NL/1a"
      ],
      "mandatory_tax_text": null,
      "created_at": "2026-03-16T14:44:35.712Z",
      "updated_at": "2026-03-16T14:44:35.712Z"
    }
  ],
  "payments": [],
  "total_paid": "0.0",
  "total_unpaid": "157.24",
  "total_unpaid_base": "157.24",
  "prices_are_incl_tax": false,
  "total_price_excl_tax": "129.95",
  "total_price_excl_tax_base": "129.95",
  "total_price_incl_tax": "157.24",
  "total_price_incl_tax_base": "157.24",
  "marked_dubious_on": null,
  "marked_uncollectible_on": null,
  "notes": [],
  "attachments": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": 17736721351849,
      "action": "external_sales_invoice_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-03-16T14:44:35.715Z",
      "updated_at": "2026-03-16T14:44:35.715Z"
    }
  ],
  "tax_totals": [
    {
      "tax_rate_id": "481770606626342257",
      "taxable_amount": "129.95",
      "taxable_amount_base": "129.95",
      "tax_amount": "27.29",
      "tax_amount_base": "27.29"
    }
  ]
}

json

application/json

Estimates Financial accounts