Moneybird API

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

POST/{administration_id}/external_sales_invoices/attachment{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/external_sales_invoices/attachment:format \
  --header 'Content-Type: application/json' \
  --data '{
  "file": "file"
}'

shell

Example Request Body

{
  "file": "file"
}

json

Example Responses

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

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

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

shell

Example Responses

<?xml version="1.0" encoding="UTF-8"?>
<hash>
  <message>Use the Location header to download the attachment</message>
</hash>

plain

text/plain

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

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

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

shell

Example Responses

No example specified for this content type

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

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

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

shell

Example Responses

No example specified for this content type

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": 471699981331334700,
    "todo": true
  }
}
'

shell

Example Request Body

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

json

application/json

Example Responses

{
  "id": "471699981356500539",
  "administration_id": 123,
  "entity_id": "471699981321897527",
  "entity_type": "ExternalSalesInvoice",
  "user_id": 17640679459010,
  "assignee_id": "471699981331334713",
  "todo": true,
  "note": "Text of the note",
  "completed_at": null,
  "completed_by_id": null,
  "todo_type": null,
  "data": {},
  "created_at": "2025-11-25T10:56:18.989Z",
  "updated_at": "2025-11-25T10:56:18.989Z"
}

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

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

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

shell

Example Responses

No example specified for this content type

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": "2025-11-25T10:56:19.224Z",
    "price": "121.0"
  }
}
'

shell

Example Request Body

{
  "payment": {
    "payment_date": "2025-11-25T10:56:19.224Z",
    "price": "121.0"
  }
}

json

application/json

Example Responses

{
  "id": "471699981618644571",
  "administration_id": 123,
  "invoice_type": "ExternalSalesInvoice",
  "invoice_id": "471699981596624473",
  "financial_account_id": null,
  "user_id": 17640679459010,
  "payment_transaction_id": null,
  "transaction_identifier": null,
  "price": "121.0",
  "price_base": "121.0",
  "payment_date": "2025-11-25",
  "credit_invoice_id": null,
  "financial_mutation_id": null,
  "ledger_account_id": "471699736780342400",
  "linked_payment_id": null,
  "manual_payment_action": null,
  "created_at": "2025-11-25T10:56:19.239Z",
  "updated_at": "2025-11-25T10:56:19.239Z"
}

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

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

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

shell

Example Request Body

{
  "file": "file"
}

json

Example Responses

json

application/json

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": "471699984033515333",
  "administration_id": 123,
  "contact_id": "471699984019883843",
  "contact": {
    "id": "471699984019883843",
    "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",
    "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": "2025-11-25T10:56:21.529Z",
    "updated_at": "2025-11-25T10:56:21.529Z",
    "version": 1764068181,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000001/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "date": "2025-08-27",
  "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": "2025-11-25T10:56:21.542Z",
  "updated_at": "2025-11-25T10:56:21.804Z",
  "version": 1764068181,
  "details": [
    {
      "id": "471699984034563910",
      "administration_id": 123,
      "tax_rate_id": "471699984015689537",
      "ledger_account_id": "471699984024078148",
      "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": "2025-11-25T10:56:21.544Z",
      "updated_at": "2025-11-25T10:56:21.544Z"
    }
  ],
  "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": "2025-11-25",
  "marked_uncollectible_on": null,
  "notes": [],
  "attachments": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "external_sales_invoice_marked_as_dubious",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-11-25T10:56:21.807Z",
      "updated_at": "2025-11-25T10:56:21.807Z"
    }
  ],
  "tax_totals": [
    {
      "tax_rate_id": "471699984015689537",
      "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": "471699984631203712",
  "administration_id": 123,
  "contact_id": "471699984616523646",
  "contact": {
    "id": "471699984616523646",
    "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",
    "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": "2025-11-25T10:56:22.098Z",
    "updated_at": "2025-11-25T10:56:22.098Z",
    "version": 1764068182,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000001/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "date": "2025-08-27",
  "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": "2025-11-25T10:56:22.112Z",
  "updated_at": "2025-11-25T10:56:22.532Z",
  "version": 1764068182,
  "details": [
    {
      "id": "471699984633300865",
      "administration_id": 123,
      "tax_rate_id": "471699984612329340",
      "ledger_account_id": "471699984620717951",
      "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": "2025-11-25T10:56:22.114Z",
      "updated_at": "2025-11-25T10:56:22.531Z"
    }
  ],
  "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": "2025-11-25",
  "notes": [],
  "attachments": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "external_sales_invoice_state_changed_to_uncollectible",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-11-25T10:56:22.519Z",
      "updated_at": "2025-11-25T10:56:22.519Z"
    },
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "external_sales_invoice_marked_as_uncollectible",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-11-25T10:56:22.536Z",
      "updated_at": "2025-11-25T10:56:22.536Z"
    }
  ],
  "tax_totals": [
    {
      "tax_rate_id": "471699984612329340",
      "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 invoices 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

A 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": "471699981531612755",
  "administration_id": 123,
  "contact_id": "471699981521126993",
  "contact": {
    "id": "471699981521126993",
    "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",
    "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": "2025-11-25T10:56:19.146Z",
    "updated_at": "2025-11-25T10:56:19.146Z",
    "version": 1764068179,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000001/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "date": "2025-11-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": "2025-11-25T10:56:19.157Z",
  "updated_at": "2025-11-25T10:56:19.160Z",
  "version": 1764068179,
  "details": [
    {
      "id": "471699981533709908",
      "administration_id": 123,
      "tax_rate_id": "471699981516932687",
      "ledger_account_id": "471699981525321298",
      "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": "2025-11-25T10:56:19.158Z",
      "updated_at": "2025-11-25T10:56:19.158Z"
    }
  ],
  "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": "471699981516932687",
      "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

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

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

shell

Example Responses

No example specified for this content type

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": 471699982831847100,
        "_destroy": true
      }
    ]
  }
}
'

shell

Example Request Body

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

json

application/json

Example Responses

{
  "id": "471699982830798522",
  "administration_id": 123,
  "contact_id": "471699982819264184",
  "contact": {
    "id": "471699982819264184",
    "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",
    "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": "2025-11-25T10:56:20.385Z",
    "updated_at": "2025-11-25T10:56:20.385Z",
    "version": 1764068180,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000001/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "date": "2025-11-25",
  "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": "2025-11-25T10:56:20.395Z",
  "updated_at": "2025-11-25T10:56:20.435Z",
  "version": 1764068180,
  "details": [
    {
      "id": "471699982870644413",
      "administration_id": 123,
      "tax_rate_id": "471699736823334023",
      "ledger_account_id": "471699736746787959",
      "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": "2025-11-25T10:56:20.433Z",
      "updated_at": "2025-11-25T10:56:20.433Z"
    }
  ],
  "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": 17640679459010,
      "action": "external_sales_invoice_updated",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-11-25T10:56:20.436Z",
      "updated_at": "2025-11-25T10:56:20.436Z"
    }
  ],
  "tax_totals": [
    {
      "tax_rate_id": "471699736823334023",
      "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 sales invoices in the administration.

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 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": "471699986815387576",
    "administration_id": 123,
    "contact_id": "471699986803853238",
    "contact": {
      "id": "471699986803853238",
      "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",
      "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": "2025-11-25T10:56:24.184Z",
      "updated_at": "2025-11-25T10:56:24.184Z",
      "version": 1764068184,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000003/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "date": "2025-11-25",
    "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": "2025-11-25T10:56:24.195Z",
    "updated_at": "2025-11-25T10:56:24.198Z",
    "version": 1764068184,
    "details": [
      {
        "id": "471699986816436153",
        "administration_id": 123,
        "tax_rate_id": "471699986799658932",
        "ledger_account_id": "471699986808047543",
        "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": "2025-11-25T10:56:24.196Z",
        "updated_at": "2025-11-25T10:56:24.196Z"
      }
    ],
    "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": "471699986799658932",
        "taxable_amount": "100.0",
        "taxable_amount_base": "100.0",
        "tax_amount": "21.0",
        "tax_amount_base": "21.0"
      }
    ]
  },
  {
    "id": "471699986794416050",
    "administration_id": 123,
    "contact_id": "471699986783930288",
    "contact": {
      "id": "471699986783930288",
      "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",
      "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": "2025-11-25T10:56:24.165Z",
      "updated_at": "2025-11-25T10:56:24.165Z",
      "version": 1764068184,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000002/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "date": "2025-11-25",
    "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": "2025-11-25T10:56:24.175Z",
    "updated_at": "2025-11-25T10:56:24.178Z",
    "version": 1764068184,
    "details": [
      {
        "id": "471699986795464627",
        "administration_id": 123,
        "tax_rate_id": "471699986779735982",
        "ledger_account_id": "471699986788124593",
        "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": "2025-11-25T10:56:24.176Z",
        "updated_at": "2025-11-25T10:56:24.176Z"
      }
    ],
    "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": "471699986779735982",
        "taxable_amount": "100.0",
        "taxable_amount_base": "100.0",
        "tax_amount": "21.0",
        "tax_amount_base": "21.0"
      }
    ]
  },
  {
    "id": "471699986773444524",
    "administration_id": 123,
    "contact_id": "471699986761910186",
    "contact": {
      "id": "471699986761910186",
      "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",
      "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": "2025-11-25T10:56:24.145Z",
      "updated_at": "2025-11-25T10:56:24.145Z",
      "version": 1764068184,
      "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000001/all",
      "notes": [],
      "custom_fields": [],
      "contact_people": [],
      "archived": false
    },
    "date": "2025-11-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": "2025-11-25T10:56:24.156Z",
    "updated_at": "2025-11-25T10:56:24.159Z",
    "version": 1764068184,
    "details": [
      {
        "id": "471699986775541677",
        "administration_id": 123,
        "tax_rate_id": "471699986757715880",
        "ledger_account_id": "471699986766104491",
        "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": "2025-11-25T10:56:24.157Z",
        "updated_at": "2025-11-25T10:56:24.157Z"
      }
    ],
    "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": "471699986757715880",
        "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": 471699983205140200,
    "currency": "USD",
    "details_attributes": [
      {
        "description": "Rocking Chair",
        "price": 159.99,
        "tax_rate_id": 471699983200945900
      }
    ]
  }
}
'

shell

Example Request Body

{
  "external_sales_invoice": {
    "reference": "30052",
    "contact_id": 471699983205140200,
    "currency": "USD",
    "details_attributes": [
      {
        "description": "Rocking Chair",
        "price": 159.99,
        "tax_rate_id": 471699983200945900
      }
    ]
  }
}

json

application/json

Example Responses

{
  "id": "471699983235548911",
  "administration_id": 123,
  "contact_id": "471699983205140205",
  "contact": {
    "id": "471699983205140205",
    "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",
    "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": "2025-11-25T10:56:20.751Z",
    "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": "2025-11-25T10:56:20.753Z",
    "updated_at": "2025-11-25T10:56:20.753Z",
    "version": 1764068180,
    "sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0000000000000000000000000000000000000000000000000000000000000002/all",
    "notes": [],
    "custom_fields": [],
    "contact_people": [],
    "archived": false
  },
  "date": "2025-11-25",
  "state": "open",
  "due_date": null,
  "reference": "30052",
  "entry_number": 1,
  "origin": "api",
  "source": null,
  "source_url": null,
  "currency": "USD",
  "paid_at": null,
  "created_at": "2025-11-25T10:56:20.782Z",
  "updated_at": "2025-11-25T10:56:20.785Z",
  "version": 1764068180,
  "details": [
    {
      "id": "471699983237646064",
      "administration_id": 123,
      "tax_rate_id": "471699983200945899",
      "ledger_account_id": "471699736746787959",
      "project_id": null,
      "product_id": null,
      "amount": null,
      "amount_decimal": "1.0",
      "description": "Rocking Chair",
      "price": "159.99",
      "period": null,
      "row_order": 0,
      "total_price_excl_tax_with_discount": "159.99",
      "total_price_excl_tax_with_discount_base": "127.99",
      "tax_report_reference": [
        "NL/3a"
      ],
      "mandatory_tax_text": "Intracommunautaire levering, artikel 138, lid 1, Richtlijn 2006/112",
      "created_at": "2025-11-25T10:56:20.783Z",
      "updated_at": "2025-11-25T10:56:20.783Z"
    }
  ],
  "payments": [],
  "total_paid": "0.0",
  "total_unpaid": "159.99",
  "total_unpaid_base": "127.99",
  "prices_are_incl_tax": false,
  "total_price_excl_tax": "159.99",
  "total_price_excl_tax_base": "127.99",
  "total_price_incl_tax": "159.99",
  "total_price_incl_tax_base": "127.99",
  "marked_dubious_on": null,
  "marked_uncollectible_on": null,
  "notes": [],
  "attachments": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "external_sales_invoice_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-11-25T10:56:20.787Z",
      "updated_at": "2025-11-25T10:56:20.787Z"
    }
  ],
  "tax_totals": []
}

json

application/json

Estimates Financial accounts