Sales invoices
List all invoices
Returns a paginated list of all sales invoices in the administration.
The filter argument allows you to filter the list of invoices. Filters are a combination of keys and values,
separated by a comma: period:this_year,state:all. The available options for filtering are:
| Filter | Type | Default | Description |
| state | String |
all |
all, draft, open, scheduled, pending_payment, late, reminded, paid or uncollectible |
| 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) |
| reference | String |
Select invoices with a certain reference | |
| contact_id | Integer |
Select invoices belonging to a certain contact | |
| recurring_sales_invoice_id | Integer |
Select invoices created by a certain recurring invoice | |
| workflow_id | Integer |
Select invoices that use a certain workflow | |
| created_after | String |
Select invoices created after the given time (exclusive). ISO 8601 formatted string. The time to compare with is in UTC timezone | |
| updated_after | String |
Select invoices updated after the given time (exclusive). ISO 8601 formatted string. The time to compare with is in UTC timezone |
You can filter by multiple states at the same time as well. To do this, separate the state values by a pipe: state:draft|scheduled. This also holds for the reference.
Parameters
| Parameter | Type | Description |
|---|---|---|
filter |
String |
Example: returns all invoices of an administration
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/sales_invoices.json?
Response
Status: 200 OK
[
{
"id": "433546329266848983",
"administration_id": 123,
"contact_id": "433546328799184069",
"contact": {
"id": "433546328799184069",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:20.437Z",
"updated_at": "2024-09-30T07:40:20.437Z",
"version": 1727682020,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/2884fb166f2bf4b0e4da3d6f4984428292f24156f7ef7a166c15e890a2ee7e00/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"invoice_id": "2024-0003",
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": null,
"state": "open",
"invoice_date": "2024-09-30",
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": "RF360000000000000EUF4Z4WJ",
"short_payment_reference": "RF36EUF4Z4WJ",
"reference": "Project X",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": "2024-09-30",
"created_at": "2024-09-30T07:40:20.883Z",
"updated_at": "2024-09-30T07:40:20.990Z",
"public_view_code": "344053",
"public_view_code_expires_at": "2024-12-30T07:40:20.946Z",
"version": 1727682020,
"details": [
{
"id": "433546329268946136",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "1 x",
"amount_decimal": "1.0",
"description": "Project X",
"price": "300.0",
"period": null,
"row_order": 1,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:20.886Z",
"updated_at": "2024-09-30T07:40:20.988Z"
}
],
"payments": [
],
"total_paid": "0.0",
"total_unpaid": "363.0",
"total_unpaid_base": "363.0",
"prices_are_incl_tax": false,
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": "2024-10-14",
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/ff2f10daadeaeaecdb146117e6aa05f6e479408df71b9ae13a0b6ad71d273b5d/2884fb166f2bf4b0e4da3d6f4984428292f24156f7ef7a166c15e890a2ee7e00",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/ff2f10daadeaeaecdb146117e6aa05f6e479408df71b9ae13a0b6ad71d273b5d/2884fb166f2bf4b0e4da3d6f4984428292f24156f7ef7a166c15e890a2ee7e00/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:20.890Z",
"updated_at": "2024-09-30T07:40:20.890Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_state_changed_to_open",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:20.963Z",
"updated_at": "2024-09-30T07:40:20.963Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_send_email",
"link_entity_id": null,
"link_entity_type": null,
"data": {
"email_address": "info@example.com",
"email_message": "Geachte Foobar Holding B.V.,\n\nIn de bijlage kunt u factuur 2024-0003 voor onze diensten vinden. Wij verzoeken u vriendelijk de factuur voor 14-10-2024 te voldoen.\n\nMet vriendelijke groet,\n\nParkietje B.V."
},
"created_at": "2024-09-30T07:40:21.006Z",
"updated_at": "2024-09-30T07:40:21.006Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "300.0",
"taxable_amount_base": "300.0",
"tax_amount": "63.0",
"tax_amount_base": "63.0"
}
]
},
{
"id": "433546329059230929",
"administration_id": 123,
"contact_id": "433546328799184069",
"contact": {
"id": "433546328799184069",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:20.437Z",
"updated_at": "2024-09-30T07:40:20.437Z",
"version": 1727682020,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/2884fb166f2bf4b0e4da3d6f4984428292f24156f7ef7a166c15e890a2ee7e00/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"invoice_id": "2024-0002",
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": null,
"state": "open",
"invoice_date": "2024-09-30",
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": "RF3400000000000004QHEXZ97",
"short_payment_reference": "RF344QHEXZ97",
"reference": "Project X",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": "2024-09-30",
"created_at": "2024-09-30T07:40:20.686Z",
"updated_at": "2024-09-30T07:40:20.800Z",
"public_view_code": "236695",
"public_view_code_expires_at": "2024-12-30T07:40:20.753Z",
"version": 1727682020,
"details": [
{
"id": "433546329061328082",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "1 x",
"amount_decimal": "1.0",
"description": "Project X",
"price": "300.0",
"period": null,
"row_order": 1,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:20.688Z",
"updated_at": "2024-09-30T07:40:20.799Z"
}
],
"payments": [
],
"total_paid": "0.0",
"total_unpaid": "363.0",
"total_unpaid_base": "363.0",
"prices_are_incl_tax": false,
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": "2024-10-14",
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/27bf649f3cd9c9a37b1303bad59962b8e6aba512d07604ee61b2925a9f0ad85c/2884fb166f2bf4b0e4da3d6f4984428292f24156f7ef7a166c15e890a2ee7e00",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/27bf649f3cd9c9a37b1303bad59962b8e6aba512d07604ee61b2925a9f0ad85c/2884fb166f2bf4b0e4da3d6f4984428292f24156f7ef7a166c15e890a2ee7e00/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:20.692Z",
"updated_at": "2024-09-30T07:40:20.692Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_state_changed_to_open",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:20.772Z",
"updated_at": "2024-09-30T07:40:20.772Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_send_email",
"link_entity_id": null,
"link_entity_type": null,
"data": {
"email_address": "info@example.com",
"email_message": "Geachte Foobar Holding B.V.,\n\nIn de bijlage kunt u factuur 2024-0002 voor onze diensten vinden. Wij verzoeken u vriendelijk de factuur voor 14-10-2024 te voldoen.\n\nMet vriendelijke groet,\n\nParkietje B.V."
},
"created_at": "2024-09-30T07:40:20.815Z",
"updated_at": "2024-09-30T07:40:20.815Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "300.0",
"taxable_amount_base": "300.0",
"tax_amount": "63.0",
"tax_amount_base": "63.0"
}
]
},
{
"id": "433546328867341514",
"administration_id": 123,
"contact_id": "433546328799184069",
"contact": {
"id": "433546328799184069",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:20.437Z",
"updated_at": "2024-09-30T07:40:20.437Z",
"version": 1727682020,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/2884fb166f2bf4b0e4da3d6f4984428292f24156f7ef7a166c15e890a2ee7e00/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": "433546328814912712",
"contact_person": {
"id": null,
"contact_id": "433546328799184069",
"administration_id": 123,
"firstname": "Jan",
"lastname": "Janssen",
"phone": "123-456-2346",
"email": "janjanssen@dev.null.moneybird.net",
"department": "Sales",
"created_at": "2024-09-30T07:40:20.452Z",
"updated_at": "2024-09-30T07:40:20.452Z",
"version": 1727682020
},
"invoice_id": "2024-0001",
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": null,
"state": "open",
"invoice_date": "2024-09-30",
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": "RF910000000000000QY2NHFU5",
"short_payment_reference": "RF91QY2NHFU5",
"reference": "Project X",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": "2024-09-30",
"created_at": "2024-09-30T07:40:20.502Z",
"updated_at": "2024-09-30T07:40:20.611Z",
"public_view_code": "222411",
"public_view_code_expires_at": "2024-12-30T07:40:20.564Z",
"version": 1727682020,
"details": [
{
"id": "433546328870487243",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "1 x",
"amount_decimal": "1.0",
"description": "Project X",
"price": "300.0",
"period": "20240901..20240930",
"row_order": 1,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:20.507Z",
"updated_at": "2024-09-30T07:40:20.609Z"
}
],
"payments": [
],
"total_paid": "0.0",
"total_unpaid": "363.0",
"total_unpaid_base": "363.0",
"prices_are_incl_tax": false,
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": "2024-10-14",
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/13764a79b11a5a0c6b89ce1a48963f3d8a036859500d4451b55428947fa1bb2b/2884fb166f2bf4b0e4da3d6f4984428292f24156f7ef7a166c15e890a2ee7e00",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/13764a79b11a5a0c6b89ce1a48963f3d8a036859500d4451b55428947fa1bb2b/2884fb166f2bf4b0e4da3d6f4984428292f24156f7ef7a166c15e890a2ee7e00/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:20.510Z",
"updated_at": "2024-09-30T07:40:20.510Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_state_changed_to_open",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:20.581Z",
"updated_at": "2024-09-30T07:40:20.581Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_send_email",
"link_entity_id": null,
"link_entity_type": null,
"data": {
"email_address": "info@example.com; janjanssen@dev.null.moneybird.net",
"email_message": "Geachte Jan Janssen,\n\nIn de bijlage kunt u factuur 2024-0001 voor onze diensten vinden. Wij verzoeken u vriendelijk de factuur voor 14-10-2024 te voldoen.\n\nMet vriendelijke groet,\n\nParkietje B.V."
},
"created_at": "2024-09-30T07:40:20.627Z",
"updated_at": "2024-09-30T07:40:20.627Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "300.0",
"taxable_amount_base": "300.0",
"tax_amount": "63.0",
"tax_amount_base": "63.0"
}
]
}
]
Example: returns all invoices filtered on period
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/sales_invoices.json?filter=period%3Athis_month
Response
Status: 200 OK
[
{
"id": "433546329997706481",
"administration_id": 123,
"contact_id": "433546329522701535",
"contact": {
"id": "433546329522701535",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:21.128Z",
"updated_at": "2024-09-30T07:40:21.128Z",
"version": 1727682021,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/419c0d4ebbbf9fcf430ae9a4db23112ef221125dc846cad115d01bf741275b07/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"invoice_id": "2024-0003",
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": null,
"state": "open",
"invoice_date": "2024-09-30",
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": "RF5900000000000007S33GCMN",
"short_payment_reference": "RF597S33GCMN",
"reference": "Project X",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": "2024-09-30",
"created_at": "2024-09-30T07:40:21.581Z",
"updated_at": "2024-09-30T07:40:21.697Z",
"public_view_code": "221177",
"public_view_code_expires_at": "2024-12-30T07:40:21.646Z",
"version": 1727682021,
"details": [
{
"id": "433546329999803634",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "1 x",
"amount_decimal": "1.0",
"description": "Project X",
"price": "300.0",
"period": null,
"row_order": 1,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:21.584Z",
"updated_at": "2024-09-30T07:40:21.695Z"
}
],
"payments": [
],
"total_paid": "0.0",
"total_unpaid": "363.0",
"total_unpaid_base": "363.0",
"prices_are_incl_tax": false,
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": "2024-10-14",
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/15074884ce47ed49318985688e9ef2be03a38e896e5489e1a18f6e6015345969/419c0d4ebbbf9fcf430ae9a4db23112ef221125dc846cad115d01bf741275b07",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/15074884ce47ed49318985688e9ef2be03a38e896e5489e1a18f6e6015345969/419c0d4ebbbf9fcf430ae9a4db23112ef221125dc846cad115d01bf741275b07/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:21.587Z",
"updated_at": "2024-09-30T07:40:21.587Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_state_changed_to_open",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:21.665Z",
"updated_at": "2024-09-30T07:40:21.665Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_send_email",
"link_entity_id": null,
"link_entity_type": null,
"data": {
"email_address": "info@example.com",
"email_message": "Geachte Foobar Holding B.V.,\n\nIn de bijlage kunt u factuur 2024-0003 voor onze diensten vinden. Wij verzoeken u vriendelijk de factuur voor 14-10-2024 te voldoen.\n\nMet vriendelijke groet,\n\nParkietje B.V."
},
"created_at": "2024-09-30T07:40:21.714Z",
"updated_at": "2024-09-30T07:40:21.714Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "300.0",
"taxable_amount_base": "300.0",
"tax_amount": "63.0",
"tax_amount_base": "63.0"
}
]
},
{
"id": "433546329794282731",
"administration_id": 123,
"contact_id": "433546329522701535",
"contact": {
"id": "433546329522701535",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:21.128Z",
"updated_at": "2024-09-30T07:40:21.128Z",
"version": 1727682021,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/419c0d4ebbbf9fcf430ae9a4db23112ef221125dc846cad115d01bf741275b07/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"invoice_id": "2024-0002",
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": null,
"state": "open",
"invoice_date": "2024-09-30",
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": "RF55000000000000096NTJW5C",
"short_payment_reference": "RF5596NTJW5C",
"reference": "Project X",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": "2024-09-30",
"created_at": "2024-09-30T07:40:21.386Z",
"updated_at": "2024-09-30T07:40:21.501Z",
"public_view_code": "585162",
"public_view_code_expires_at": "2024-12-30T07:40:21.454Z",
"version": 1727682021,
"details": [
{
"id": "433546329798477036",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "1 x",
"amount_decimal": "1.0",
"description": "Project X",
"price": "300.0",
"period": null,
"row_order": 1,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:21.391Z",
"updated_at": "2024-09-30T07:40:21.499Z"
}
],
"payments": [
],
"total_paid": "0.0",
"total_unpaid": "363.0",
"total_unpaid_base": "363.0",
"prices_are_incl_tax": false,
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": "2024-10-14",
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/6274d8441320047ab4301e773050a53ca0c61d34b282a9311de59ea7d9833c8f/419c0d4ebbbf9fcf430ae9a4db23112ef221125dc846cad115d01bf741275b07",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/6274d8441320047ab4301e773050a53ca0c61d34b282a9311de59ea7d9833c8f/419c0d4ebbbf9fcf430ae9a4db23112ef221125dc846cad115d01bf741275b07/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:21.396Z",
"updated_at": "2024-09-30T07:40:21.396Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_state_changed_to_open",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:21.472Z",
"updated_at": "2024-09-30T07:40:21.472Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_send_email",
"link_entity_id": null,
"link_entity_type": null,
"data": {
"email_address": "info@example.com",
"email_message": "Geachte Foobar Holding B.V.,\n\nIn de bijlage kunt u factuur 2024-0002 voor onze diensten vinden. Wij verzoeken u vriendelijk de factuur voor 14-10-2024 te voldoen.\n\nMet vriendelijke groet,\n\nParkietje B.V."
},
"created_at": "2024-09-30T07:40:21.518Z",
"updated_at": "2024-09-30T07:40:21.518Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "300.0",
"taxable_amount_base": "300.0",
"tax_amount": "63.0",
"tax_amount_base": "63.0"
}
]
},
{
"id": "433546329585616100",
"administration_id": 123,
"contact_id": "433546329522701535",
"contact": {
"id": "433546329522701535",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:21.128Z",
"updated_at": "2024-09-30T07:40:21.128Z",
"version": 1727682021,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/419c0d4ebbbf9fcf430ae9a4db23112ef221125dc846cad115d01bf741275b07/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": "433546329535284450",
"contact_person": {
"id": null,
"contact_id": "433546329522701535",
"administration_id": 123,
"firstname": "Jan",
"lastname": "Janssen",
"phone": "123-456-2346",
"email": "janjanssen@dev.null.moneybird.net",
"department": "Sales",
"created_at": "2024-09-30T07:40:21.140Z",
"updated_at": "2024-09-30T07:40:21.140Z",
"version": 1727682021
},
"invoice_id": "2024-0001",
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": null,
"state": "open",
"invoice_date": "2024-09-30",
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": "RF7800000000000007CTZZX5E",
"short_payment_reference": "RF787CTZZX5E",
"reference": "Project X",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": "2024-09-30",
"created_at": "2024-09-30T07:40:21.188Z",
"updated_at": "2024-09-30T07:40:21.311Z",
"public_view_code": "190316",
"public_view_code_expires_at": "2024-12-30T07:40:21.257Z",
"version": 1727682021,
"details": [
{
"id": "433546329588761829",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "1 x",
"amount_decimal": "1.0",
"description": "Project X",
"price": "300.0",
"period": "20240901..20240930",
"row_order": 1,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:21.191Z",
"updated_at": "2024-09-30T07:40:21.310Z"
}
],
"payments": [
],
"total_paid": "0.0",
"total_unpaid": "363.0",
"total_unpaid_base": "363.0",
"prices_are_incl_tax": false,
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": "2024-10-14",
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/fd1a7cc563c02682977d79a98238e2e74daed3159ee6a92856887155d807b6f9/419c0d4ebbbf9fcf430ae9a4db23112ef221125dc846cad115d01bf741275b07",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/fd1a7cc563c02682977d79a98238e2e74daed3159ee6a92856887155d807b6f9/419c0d4ebbbf9fcf430ae9a4db23112ef221125dc846cad115d01bf741275b07/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:21.195Z",
"updated_at": "2024-09-30T07:40:21.195Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_state_changed_to_open",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:21.278Z",
"updated_at": "2024-09-30T07:40:21.278Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_send_email",
"link_entity_id": null,
"link_entity_type": null,
"data": {
"email_address": "info@example.com; janjanssen@dev.null.moneybird.net",
"email_message": "Geachte Jan Janssen,\n\nIn de bijlage kunt u factuur 2024-0001 voor onze diensten vinden. Wij verzoeken u vriendelijk de factuur voor 14-10-2024 te voldoen.\n\nMet vriendelijke groet,\n\nParkietje B.V."
},
"created_at": "2024-09-30T07:40:21.328Z",
"updated_at": "2024-09-30T07:40:21.328Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "300.0",
"taxable_amount_base": "300.0",
"tax_amount": "63.0",
"tax_amount_base": "63.0"
}
]
}
]
Example: returns all invoices filtered on state
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/sales_invoices.json?filter=state%3Alate
Response
Status: 200 OK
[
]
Example: returns paginated sales invoices on page 1
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/sales_invoices.json?per_page=1
Response
Status: 200 OK
[
{
"id": "433546331452081445",
"administration_id": 123,
"contact_id": "433546330991756563",
"contact": {
"id": "433546330991756563",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:22.529Z",
"updated_at": "2024-09-30T07:40:22.529Z",
"version": 1727682022,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/e3090b5ea44992a50e312b6c4cda7c633985cffae21224edda4784fdc9b14b50/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"invoice_id": "2024-0003",
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": null,
"state": "open",
"invoice_date": "2024-09-30",
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": "RF150000000000000U3T67QR4",
"short_payment_reference": "RF15U3T67QR4",
"reference": "Project X",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": "2024-09-30",
"created_at": "2024-09-30T07:40:22.968Z",
"updated_at": "2024-09-30T07:40:23.066Z",
"public_view_code": "505571",
"public_view_code_expires_at": "2024-12-30T07:40:23.023Z",
"version": 1727682023,
"details": [
{
"id": "433546331455227174",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "1 x",
"amount_decimal": "1.0",
"description": "Project X",
"price": "300.0",
"period": null,
"row_order": 1,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:22.971Z",
"updated_at": "2024-09-30T07:40:23.065Z"
}
],
"payments": [
],
"total_paid": "0.0",
"total_unpaid": "363.0",
"total_unpaid_base": "363.0",
"prices_are_incl_tax": false,
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": "2024-10-14",
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/037238ff25184eea019fd7a85b3d87204350925a5e6191cf4585d520a0747339/e3090b5ea44992a50e312b6c4cda7c633985cffae21224edda4784fdc9b14b50",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/037238ff25184eea019fd7a85b3d87204350925a5e6191cf4585d520a0747339/e3090b5ea44992a50e312b6c4cda7c633985cffae21224edda4784fdc9b14b50/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:22.974Z",
"updated_at": "2024-09-30T07:40:22.974Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_state_changed_to_open",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:23.039Z",
"updated_at": "2024-09-30T07:40:23.039Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_send_email",
"link_entity_id": null,
"link_entity_type": null,
"data": {
"email_address": "info@example.com",
"email_message": "Geachte Foobar Holding B.V.,\n\nIn de bijlage kunt u factuur 2024-0003 voor onze diensten vinden. Wij verzoeken u vriendelijk de factuur voor 14-10-2024 te voldoen.\n\nMet vriendelijke groet,\n\nParkietje B.V."
},
"created_at": "2024-09-30T07:40:23.083Z",
"updated_at": "2024-09-30T07:40:23.083Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "300.0",
"taxable_amount_base": "300.0",
"tax_amount": "63.0",
"tax_amount_base": "63.0"
}
]
}
]
Example: returns paginated sales invoices on page 2
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/sales_invoices.json?page=2&per_page=1
Response
Status: 200 OK
[
{
"id": "433546331957495097",
"administration_id": 123,
"contact_id": "433546331699545389",
"contact": {
"id": "433546331699545389",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:23.204Z",
"updated_at": "2024-09-30T07:40:23.204Z",
"version": 1727682023,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/797eed79a92462ce9019b43d9d8624c059858520126a201a2c124987fa991ebb/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"invoice_id": "2024-0002",
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": null,
"state": "open",
"invoice_date": "2024-09-30",
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": "RF5600000000000006DD9K6T9",
"short_payment_reference": "RF566DD9K6T9",
"reference": "Project X",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": "2024-09-30",
"created_at": "2024-09-30T07:40:23.450Z",
"updated_at": "2024-09-30T07:40:23.588Z",
"public_view_code": "597578",
"public_view_code_expires_at": "2024-12-30T07:40:23.543Z",
"version": 1727682023,
"details": [
{
"id": "433546331960640826",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "1 x",
"amount_decimal": "1.0",
"description": "Project X",
"price": "300.0",
"period": null,
"row_order": 1,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:23.453Z",
"updated_at": "2024-09-30T07:40:23.586Z"
}
],
"payments": [
],
"total_paid": "0.0",
"total_unpaid": "363.0",
"total_unpaid_base": "363.0",
"prices_are_incl_tax": false,
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": "2024-10-14",
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/ce09f78ccebf5da31a2deac92558e32151de88318c5c7e7927602d753b6bd293/797eed79a92462ce9019b43d9d8624c059858520126a201a2c124987fa991ebb",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/ce09f78ccebf5da31a2deac92558e32151de88318c5c7e7927602d753b6bd293/797eed79a92462ce9019b43d9d8624c059858520126a201a2c124987fa991ebb/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:23.459Z",
"updated_at": "2024-09-30T07:40:23.459Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_state_changed_to_open",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:23.562Z",
"updated_at": "2024-09-30T07:40:23.562Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_send_email",
"link_entity_id": null,
"link_entity_type": null,
"data": {
"email_address": "info@example.com",
"email_message": "Geachte Foobar Holding B.V.,\n\nIn de bijlage kunt u factuur 2024-0002 voor onze diensten vinden. Wij verzoeken u vriendelijk de factuur voor 14-10-2024 te voldoen.\n\nMet vriendelijke groet,\n\nParkietje B.V."
},
"created_at": "2024-09-30T07:40:23.605Z",
"updated_at": "2024-09-30T07:40:23.605Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "300.0",
"taxable_amount_base": "300.0",
"tax_amount": "63.0",
"tax_amount_base": "63.0"
}
]
}
]
Example: returns an error when too many sales invoices are requested
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/sales_invoices.json?per_page=101
Response
Status: 400 Bad Request
{
"error": "Per Page is too big",
"symbolic": {
"per_page": "max"
}
}
Example: returns an error message if filter contact_id is not found
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/sales_invoices.json?filter=contact_id%3A123
Response
Status: 404 Not Found
{
"error": "record not found",
"symbolic": {
"contact_id": "not_found"
}
}
Example: returns all sales invoices created after given datetime
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/sales_invoices.json?filter=created_after%3A2024-09-29+07%3A40%3A25+UTC
Response
Status: 200 OK
[
{
"id": "433546334146921869",
"administration_id": 123,
"contact_id": "433546333708617083",
"contact": {
"id": "433546333708617083",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:25.120Z",
"updated_at": "2024-09-30T07:40:25.120Z",
"version": 1727682025,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/09e08e912f81490d8ce373011a9467c5f58e939854693ef59f46e65a436940a7/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"invoice_id": "2024-0003",
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": null,
"state": "open",
"invoice_date": "2024-09-30",
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": "RF4200000000000005A6X4J77",
"short_payment_reference": "RF425A6X4J77",
"reference": "Project X",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": "2024-09-30",
"created_at": "2024-09-30T07:40:25.537Z",
"updated_at": "2024-09-30T07:40:25.641Z",
"public_view_code": "066020",
"public_view_code_expires_at": "2024-12-30T07:40:25.593Z",
"version": 1727682025,
"details": [
{
"id": "433546334149019022",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "1 x",
"amount_decimal": "1.0",
"description": "Project X",
"price": "300.0",
"period": null,
"row_order": 1,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:25.540Z",
"updated_at": "2024-09-30T07:40:25.639Z"
}
],
"payments": [
],
"total_paid": "0.0",
"total_unpaid": "363.0",
"total_unpaid_base": "363.0",
"prices_are_incl_tax": false,
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": "2024-10-14",
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/a0922c7a71f4c0bca015a66c38016a872e96cbc40b586658746ed2423f7f0655/09e08e912f81490d8ce373011a9467c5f58e939854693ef59f46e65a436940a7",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/a0922c7a71f4c0bca015a66c38016a872e96cbc40b586658746ed2423f7f0655/09e08e912f81490d8ce373011a9467c5f58e939854693ef59f46e65a436940a7/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:25.544Z",
"updated_at": "2024-09-30T07:40:25.544Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_state_changed_to_open",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:25.610Z",
"updated_at": "2024-09-30T07:40:25.610Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_send_email",
"link_entity_id": null,
"link_entity_type": null,
"data": {
"email_address": "info@example.com",
"email_message": "Geachte Foobar Holding B.V.,\n\nIn de bijlage kunt u factuur 2024-0003 voor onze diensten vinden. Wij verzoeken u vriendelijk de factuur voor 14-10-2024 te voldoen.\n\nMet vriendelijke groet,\n\nParkietje B.V."
},
"created_at": "2024-09-30T07:40:25.660Z",
"updated_at": "2024-09-30T07:40:25.660Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "300.0",
"taxable_amount_base": "300.0",
"tax_amount": "63.0",
"tax_amount_base": "63.0"
}
]
},
{
"id": "433546333950838151",
"administration_id": 123,
"contact_id": "433546333708617083",
"contact": {
"id": "433546333708617083",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:25.120Z",
"updated_at": "2024-09-30T07:40:25.120Z",
"version": 1727682025,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/09e08e912f81490d8ce373011a9467c5f58e939854693ef59f46e65a436940a7/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"invoice_id": "2024-0002",
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": null,
"state": "open",
"invoice_date": "2024-09-30",
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": "RF170000000000000H4SK6AAM",
"short_payment_reference": "RF17H4SK6AAM",
"reference": "Project X",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": "2024-09-30",
"created_at": "2024-09-30T07:40:25.351Z",
"updated_at": "2024-09-30T07:40:25.464Z",
"public_view_code": "227652",
"public_view_code_expires_at": "2024-12-30T07:40:25.406Z",
"version": 1727682025,
"details": [
{
"id": "433546333952935304",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "1 x",
"amount_decimal": "1.0",
"description": "Project X",
"price": "300.0",
"period": null,
"row_order": 1,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:25.354Z",
"updated_at": "2024-09-30T07:40:25.463Z"
}
],
"payments": [
],
"total_paid": "0.0",
"total_unpaid": "363.0",
"total_unpaid_base": "363.0",
"prices_are_incl_tax": false,
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": "2024-10-14",
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/495fd78af8cb53e72c5211e34b0fe03560760ad93ef1be32f6de2062dbb2a02a/09e08e912f81490d8ce373011a9467c5f58e939854693ef59f46e65a436940a7",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/495fd78af8cb53e72c5211e34b0fe03560760ad93ef1be32f6de2062dbb2a02a/09e08e912f81490d8ce373011a9467c5f58e939854693ef59f46e65a436940a7/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:25.357Z",
"updated_at": "2024-09-30T07:40:25.357Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_state_changed_to_open",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:25.421Z",
"updated_at": "2024-09-30T07:40:25.421Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_send_email",
"link_entity_id": null,
"link_entity_type": null,
"data": {
"email_address": "info@example.com",
"email_message": "Geachte Foobar Holding B.V.,\n\nIn de bijlage kunt u factuur 2024-0002 voor onze diensten vinden. Wij verzoeken u vriendelijk de factuur voor 14-10-2024 te voldoen.\n\nMet vriendelijke groet,\n\nParkietje B.V."
},
"created_at": "2024-09-30T07:40:25.481Z",
"updated_at": "2024-09-30T07:40:25.481Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "300.0",
"taxable_amount_base": "300.0",
"tax_amount": "63.0",
"tax_amount_base": "63.0"
}
]
},
{
"id": "433546333774677376",
"administration_id": 123,
"contact_id": "433546333708617083",
"contact": {
"id": "433546333708617083",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:25.120Z",
"updated_at": "2024-09-30T07:40:25.120Z",
"version": 1727682025,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/09e08e912f81490d8ce373011a9467c5f58e939854693ef59f46e65a436940a7/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": "433546333720151422",
"contact_person": {
"id": null,
"contact_id": "433546333708617083",
"administration_id": 123,
"firstname": "Jan",
"lastname": "Janssen",
"phone": "123-456-2346",
"email": "janjanssen@dev.null.moneybird.net",
"department": "Sales",
"created_at": "2024-09-30T07:40:25.130Z",
"updated_at": "2024-09-30T07:40:25.130Z",
"version": 1727682025
},
"invoice_id": "2024-0001",
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": null,
"state": "open",
"invoice_date": "2024-09-30",
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": "RF3800000000000002Z33DSG9",
"short_payment_reference": "RF382Z33DSG9",
"reference": "Project X",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": "2024-09-30",
"created_at": "2024-09-30T07:40:25.183Z",
"updated_at": "2024-09-30T07:40:25.284Z",
"public_view_code": "524115",
"public_view_code_expires_at": "2024-12-30T07:40:25.237Z",
"version": 1727682025,
"details": [
{
"id": "433546333777823105",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "1 x",
"amount_decimal": "1.0",
"description": "Project X",
"price": "300.0",
"period": "20240901..20240930",
"row_order": 1,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:25.186Z",
"updated_at": "2024-09-30T07:40:25.282Z"
}
],
"payments": [
],
"total_paid": "0.0",
"total_unpaid": "363.0",
"total_unpaid_base": "363.0",
"prices_are_incl_tax": false,
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": "2024-10-14",
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/327a58d522df794872eb59bc39a7aaae44d96695bc4efac7c2c6aa1fc8a225f7/09e08e912f81490d8ce373011a9467c5f58e939854693ef59f46e65a436940a7",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/327a58d522df794872eb59bc39a7aaae44d96695bc4efac7c2c6aa1fc8a225f7/09e08e912f81490d8ce373011a9467c5f58e939854693ef59f46e65a436940a7/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:25.189Z",
"updated_at": "2024-09-30T07:40:25.189Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_state_changed_to_open",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:25.254Z",
"updated_at": "2024-09-30T07:40:25.254Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_send_email",
"link_entity_id": null,
"link_entity_type": null,
"data": {
"email_address": "info@example.com; janjanssen@dev.null.moneybird.net",
"email_message": "Geachte Jan Janssen,\n\nIn de bijlage kunt u factuur 2024-0001 voor onze diensten vinden. Wij verzoeken u vriendelijk de factuur voor 14-10-2024 te voldoen.\n\nMet vriendelijke groet,\n\nParkietje B.V."
},
"created_at": "2024-09-30T07:40:25.300Z",
"updated_at": "2024-09-30T07:40:25.300Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "300.0",
"taxable_amount_base": "300.0",
"tax_amount": "63.0",
"tax_amount_base": "63.0"
}
]
}
]
Example: returns only sales invoices updated after given datetime
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/sales_invoices.json?filter=updated_after%3A2024-09-30+07%3A40%3A31+UTC
Response
Status: 200 OK
[
{
"id": "433546335160894900",
"administration_id": 123,
"contact_id": "433546335102174639",
"contact": {
"id": "433546335102174639",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:26.449Z",
"updated_at": "2024-09-30T07:40:26.449Z",
"version": 1727682026,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/e78a73d28fa73f8bd599d95dd98d7d053d8cc21459dc7a8b9fa40368f0ce92e1/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": "433546335113708978",
"contact_person": {
"id": null,
"contact_id": "433546335102174639",
"administration_id": 123,
"firstname": "Jan",
"lastname": "Janssen",
"phone": "123-456-2346",
"email": "janjanssen@dev.null.moneybird.net",
"department": "Sales",
"created_at": "2024-09-30T07:40:26.460Z",
"updated_at": "2024-09-30T07:40:26.460Z",
"version": 1727682026
},
"invoice_id": "2024-0001",
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": null,
"state": "open",
"invoice_date": "2024-09-30",
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": "RF430000000000000TC332VN9",
"short_payment_reference": "RF43TC332VN9",
"reference": "foo",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": "2024-09-30",
"created_at": "2024-09-30T07:40:26.504Z",
"updated_at": "2024-09-30T07:41:31.998Z",
"public_view_code": "806194",
"public_view_code_expires_at": "2024-12-30T07:40:26.563Z",
"version": 1727682091,
"details": [
{
"id": "433546335162992053",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "1 x",
"amount_decimal": "1.0",
"description": "Project X",
"price": "300.0",
"period": "20240901..20240930",
"row_order": 1,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:26.507Z",
"updated_at": "2024-09-30T07:40:26.610Z"
}
],
"payments": [
],
"total_paid": "0.0",
"total_unpaid": "363.0",
"total_unpaid_base": "363.0",
"prices_are_incl_tax": false,
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": "2024-10-14",
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/2424c1376d3e90e3ef2704d12105d2c764666f40633f6f7f801098942c033b5a/e78a73d28fa73f8bd599d95dd98d7d053d8cc21459dc7a8b9fa40368f0ce92e1",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/2424c1376d3e90e3ef2704d12105d2c764666f40633f6f7f801098942c033b5a/e78a73d28fa73f8bd599d95dd98d7d053d8cc21459dc7a8b9fa40368f0ce92e1/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:26.511Z",
"updated_at": "2024-09-30T07:40:26.511Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_state_changed_to_open",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:26.579Z",
"updated_at": "2024-09-30T07:40:26.579Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_send_email",
"link_entity_id": null,
"link_entity_type": null,
"data": {
"email_address": "info@example.com; janjanssen@dev.null.moneybird.net",
"email_message": "Geachte Jan Janssen,\n\nIn de bijlage kunt u factuur 2024-0001 voor onze diensten vinden. Wij verzoeken u vriendelijk de factuur voor 14-10-2024 te voldoen.\n\nMet vriendelijke groet,\n\nParkietje B.V."
},
"created_at": "2024-09-30T07:40:26.630Z",
"updated_at": "2024-09-30T07:40:26.630Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "300.0",
"taxable_amount_base": "300.0",
"tax_amount": "63.0",
"tax_amount_base": "63.0"
}
]
}
]
List all ids and versions
Returns all sales invoices in the administration. The list contains the invoice id and the version of the invoice.
Check if the version of the invoice is newer than the version you have stored locally, use the POST
variant for fetching invoices with the given ids.
Parameters
| Parameter | Type | Description |
|---|---|---|
filter |
String |
Example: retrieves the id's for synchronization
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/sales_invoices/synchronization.json?
Response
Status: 200 OK
[
{
"id": "433546357592032516",
"version": 1727682047
},
{
"id": "433546357396997374",
"version": 1727682047
},
{
"id": "433546357216642296",
"version": 1727682047
}
]
Example: retrieves the id's for synchronization with a filter
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/sales_invoices/synchronization.json?filter=state%3Aopen
Response
Status: 200 OK
[
{
"id": "433546357752464654",
"version": 1727682048
},
{
"id": "433546357931771157",
"version": 1727682048
},
{
"id": "433546358108980507",
"version": 1727682048
}
]
Fetch sales invoices with given ids
Given a list of sales invoice ids, returns the sales invoice information belonging to the invoices. Returns a maximum of 100 invoice, even if more ids are provided.
Parameters
| Parameter | Type | Description |
|---|---|---|
ids |
Array[integer] |
Required |
Example: retrieves recurring sales invoices given by IDs
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPOST \
-d '{"ids":[433546327227368599,433546327271408795]}' \
https://moneybird.com/api/v2/123/recurring_sales_invoices/synchronization.json
Response
Status: 200 OK
[
{
"id": "433546327271408795",
"administration_id": 123,
"contact_id": "433546327186474133",
"contact": {
"id": "433546327186474133",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "2",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:18.900Z",
"updated_at": "2024-09-30T07:40:18.900Z",
"version": 1727682018,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/78a2689521ff7ae1aadfdc1895be9e0198295d62bc26464c0ab7f8663161aeae/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"workflow_id": "433546158700234574",
"start_date": "2024-10-01",
"invoice_date": "2024-10-01",
"last_date": "2024-10-01",
"active": true,
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"reference": "Project X",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"first_due_interval": 14,
"auto_send": false,
"sending_scheduled_at": null,
"sending_scheduled_user_id": null,
"frequency_type": "month",
"frequency": 1,
"created_at": "2024-09-30T07:40:18.981Z",
"updated_at": "2024-09-30T07:40:18.986Z",
"version": 1727682018,
"prices_are_incl_tax": false,
"total_price_excl_tax": "2.91",
"total_price_excl_tax_base": "2.91",
"total_price_incl_tax": "3.52",
"total_price_incl_tax_base": "3.52",
"details": [
{
"id": "433546327272457372",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "5 stuks",
"amount_decimal": "5.0",
"description": "Appels",
"price": "0.45",
"period": null,
"row_order": 1,
"total_price_excl_tax_with_discount": "2.25",
"total_price_excl_tax_with_discount_base": "2.25",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:18.983Z",
"updated_at": "2024-09-30T07:40:18.983Z"
},
{
"id": "433546327274554525",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "2 stuks",
"amount_decimal": "2.0",
"description": "Peren",
"price": "0.33",
"period": null,
"row_order": 2,
"total_price_excl_tax_with_discount": "0.66",
"total_price_excl_tax_with_discount_base": "0.66",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:18.985Z",
"updated_at": "2024-09-30T07:40:18.985Z"
}
],
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "recurring_sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:18.988Z",
"updated_at": "2024-09-30T07:40:18.988Z"
}
],
"subscription": null
},
{
"id": "433546327227368599",
"administration_id": 123,
"contact_id": "433546327186474133",
"contact": {
"id": "433546327186474133",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "2",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:18.900Z",
"updated_at": "2024-09-30T07:40:18.900Z",
"version": 1727682018,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/78a2689521ff7ae1aadfdc1895be9e0198295d62bc26464c0ab7f8663161aeae/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"workflow_id": "433546158700234574",
"start_date": "2024-10-01",
"invoice_date": "2024-10-01",
"last_date": "2024-10-01",
"active": true,
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"reference": "Project X",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"first_due_interval": 14,
"auto_send": false,
"sending_scheduled_at": null,
"sending_scheduled_user_id": null,
"frequency_type": "year",
"frequency": 1,
"created_at": "2024-09-30T07:40:18.939Z",
"updated_at": "2024-09-30T07:40:18.944Z",
"version": 1727682018,
"prices_are_incl_tax": false,
"total_price_excl_tax": "2.91",
"total_price_excl_tax_base": "2.91",
"total_price_incl_tax": "3.52",
"total_price_incl_tax_base": "3.52",
"details": [
{
"id": "433546327228417176",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "5 stuks",
"amount_decimal": "5.0",
"description": "Appels",
"price": "0.45",
"period": null,
"row_order": 1,
"total_price_excl_tax_with_discount": "2.25",
"total_price_excl_tax_with_discount_base": "2.25",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:18.941Z",
"updated_at": "2024-09-30T07:40:18.941Z"
},
{
"id": "433546327230514329",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "2 stuks",
"amount_decimal": "2.0",
"description": "Peren",
"price": "0.33",
"period": null,
"row_order": 2,
"total_price_excl_tax_with_discount": "0.66",
"total_price_excl_tax_with_discount_base": "0.66",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:18.942Z",
"updated_at": "2024-09-30T07:40:18.942Z"
}
],
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "recurring_sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:18.946Z",
"updated_at": "2024-09-30T07:40:18.946Z"
}
],
"subscription": null
}
]
Example: retrieves sales invoices given by ids
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPOST \
-d '{"ids":[433546358639559986,433546358825157944]}' \
https://moneybird.com/api/v2/123/sales_invoices/synchronization.json
Response
Status: 200 OK
[
{
"id": "433546358825157944",
"administration_id": 123,
"contact_id": "433546358379513126",
"contact": {
"id": "433546358379513126",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:48.647Z",
"updated_at": "2024-09-30T07:40:48.647Z",
"version": 1727682048,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/daa697a34525ed81dce54f97f58a4647bdcd10e109ef8f93e3847ea05b5d41aa/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"invoice_id": "2024-0003",
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": null,
"state": "open",
"invoice_date": "2024-09-30",
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": "RF620000000000000UGCN5ZMM",
"short_payment_reference": "RF62UGCN5ZMM",
"reference": "Project X",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": "2024-09-30",
"created_at": "2024-09-30T07:40:49.073Z",
"updated_at": "2024-09-30T07:40:49.180Z",
"public_view_code": "928728",
"public_view_code_expires_at": "2024-12-30T07:40:49.134Z",
"version": 1727682049,
"details": [
{
"id": "433546358828303673",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "1 x",
"amount_decimal": "1.0",
"description": "Project X",
"price": "300.0",
"period": null,
"row_order": 1,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:49.075Z",
"updated_at": "2024-09-30T07:40:49.178Z"
}
],
"payments": [
],
"total_paid": "0.0",
"total_unpaid": "363.0",
"total_unpaid_base": "363.0",
"prices_are_incl_tax": false,
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": "2024-10-14",
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/ae9574e30be828ae8c6d50d759e175c864d736b132b2df5b5b9ede14a755780c/daa697a34525ed81dce54f97f58a4647bdcd10e109ef8f93e3847ea05b5d41aa",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/ae9574e30be828ae8c6d50d759e175c864d736b132b2df5b5b9ede14a755780c/daa697a34525ed81dce54f97f58a4647bdcd10e109ef8f93e3847ea05b5d41aa/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:49.081Z",
"updated_at": "2024-09-30T07:40:49.081Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_state_changed_to_open",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:49.150Z",
"updated_at": "2024-09-30T07:40:49.150Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_send_email",
"link_entity_id": null,
"link_entity_type": null,
"data": {
"email_address": "info@example.com",
"email_message": "Geachte Foobar Holding B.V.,\n\nIn de bijlage kunt u factuur 2024-0003 voor onze diensten vinden. Wij verzoeken u vriendelijk de factuur voor 14-10-2024 te voldoen.\n\nMet vriendelijke groet,\n\nParkietje B.V."
},
"created_at": "2024-09-30T07:40:49.201Z",
"updated_at": "2024-09-30T07:40:49.201Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "300.0",
"taxable_amount_base": "300.0",
"tax_amount": "63.0",
"tax_amount_base": "63.0"
}
]
},
{
"id": "433546358639559986",
"administration_id": 123,
"contact_id": "433546358379513126",
"contact": {
"id": "433546358379513126",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:48.647Z",
"updated_at": "2024-09-30T07:40:48.647Z",
"version": 1727682048,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/daa697a34525ed81dce54f97f58a4647bdcd10e109ef8f93e3847ea05b5d41aa/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"invoice_id": "2024-0002",
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": null,
"state": "open",
"invoice_date": "2024-09-30",
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": "RF980000000000000PGAUF2JG",
"short_payment_reference": "RF98PGAUF2JG",
"reference": "Project X",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": "2024-09-30",
"created_at": "2024-09-30T07:40:48.895Z",
"updated_at": "2024-09-30T07:40:48.999Z",
"public_view_code": "791267",
"public_view_code_expires_at": "2024-12-30T07:40:48.955Z",
"version": 1727682048,
"details": [
{
"id": "433546358642705715",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "1 x",
"amount_decimal": "1.0",
"description": "Project X",
"price": "300.0",
"period": null,
"row_order": 1,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:48.899Z",
"updated_at": "2024-09-30T07:40:48.998Z"
}
],
"payments": [
],
"total_paid": "0.0",
"total_unpaid": "363.0",
"total_unpaid_base": "363.0",
"prices_are_incl_tax": false,
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": "2024-10-14",
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/d5f47ba5c6e71ef5bab774efe40e04388e7881ad529907269892979e3dc5a1aa/daa697a34525ed81dce54f97f58a4647bdcd10e109ef8f93e3847ea05b5d41aa",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/d5f47ba5c6e71ef5bab774efe40e04388e7881ad529907269892979e3dc5a1aa/daa697a34525ed81dce54f97f58a4647bdcd10e109ef8f93e3847ea05b5d41aa/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:48.903Z",
"updated_at": "2024-09-30T07:40:48.903Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_state_changed_to_open",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:48.972Z",
"updated_at": "2024-09-30T07:40:48.972Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_send_email",
"link_entity_id": null,
"link_entity_type": null,
"data": {
"email_address": "info@example.com",
"email_message": "Geachte Foobar Holding B.V.,\n\nIn de bijlage kunt u factuur 2024-0002 voor onze diensten vinden. Wij verzoeken u vriendelijk de factuur voor 14-10-2024 te voldoen.\n\nMet vriendelijke groet,\n\nParkietje B.V."
},
"created_at": "2024-09-30T07:40:49.021Z",
"updated_at": "2024-09-30T07:40:49.021Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "300.0",
"taxable_amount_base": "300.0",
"tax_amount": "63.0",
"tax_amount_base": "63.0"
}
]
}
]
Get an invoice by id
Returns a sales invoices in the administration.
Note that the link in the url attribute will only work if viewing invoices online has been enabled and the invoice is not a draft.
Example: returns invoice by given id
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/sales_invoices/433546336864830952.json?
Response
Status: 200 OK
{
"id": "433546336864830952",
"administration_id": 123,
"contact_id": "433546336795624931",
"contact": {
"id": "433546336795624931",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:28.064Z",
"updated_at": "2024-09-30T07:40:28.064Z",
"version": 1727682028,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/d00d148b21c7f8f3657e858738ee8ab5ca6de07c0535c0f9a1000914b1f48cc4/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": "433546336816596454",
"contact_person": {
"id": null,
"contact_id": "433546336795624931",
"administration_id": 123,
"firstname": "Jan",
"lastname": "Janssen",
"phone": "123-456-2346",
"email": "janjanssen@dev.null.moneybird.net",
"department": "Sales",
"created_at": "2024-09-30T07:40:28.083Z",
"updated_at": "2024-09-30T07:40:28.083Z",
"version": 1727682028
},
"invoice_id": "2024-0001",
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": null,
"state": "open",
"invoice_date": "2024-09-30",
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": "RF160000000000000YXSTZWVF",
"short_payment_reference": "RF16YXSTZWVF",
"reference": "Project X",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": "2024-09-30",
"created_at": "2024-09-30T07:40:28.130Z",
"updated_at": "2024-09-30T07:40:28.261Z",
"public_view_code": "089547",
"public_view_code_expires_at": "2024-12-30T07:40:28.210Z",
"version": 1727682028,
"details": [
{
"id": "433546336867976681",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "1 x",
"amount_decimal": "1.0",
"description": "Project X",
"price": "300.0",
"period": "20240901..20240930",
"row_order": 1,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:28.133Z",
"updated_at": "2024-09-30T07:40:28.259Z"
}
],
"payments": [
],
"total_paid": "0.0",
"total_unpaid": "363.0",
"total_unpaid_base": "363.0",
"prices_are_incl_tax": false,
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": "2024-10-14",
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/b83fd11a04a88d7c017016ea05be9ad2c29b169a7e1164cc92269d0bc6da6191/d00d148b21c7f8f3657e858738ee8ab5ca6de07c0535c0f9a1000914b1f48cc4",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/b83fd11a04a88d7c017016ea05be9ad2c29b169a7e1164cc92269d0bc6da6191/d00d148b21c7f8f3657e858738ee8ab5ca6de07c0535c0f9a1000914b1f48cc4/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:28.137Z",
"updated_at": "2024-09-30T07:40:28.137Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_state_changed_to_open",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:28.229Z",
"updated_at": "2024-09-30T07:40:28.229Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_send_email",
"link_entity_id": null,
"link_entity_type": null,
"data": {
"email_address": "info@example.com; janjanssen@dev.null.moneybird.net",
"email_message": "Geachte Jan Janssen,\n\nIn de bijlage kunt u factuur 2024-0001 voor onze diensten vinden. Wij verzoeken u vriendelijk de factuur voor 14-10-2024 te voldoen.\n\nMet vriendelijke groet,\n\nParkietje B.V."
},
"created_at": "2024-09-30T07:40:28.279Z",
"updated_at": "2024-09-30T07:40:28.279Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "300.0",
"taxable_amount_base": "300.0",
"tax_amount": "63.0",
"tax_amount_base": "63.0"
}
]
}
Example: returns 404 when invoice does not exist
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/sales_invoices/34123123.json?
Response
Status: 404 Not Found
{
"error": "record not found",
"symbolic": {
"id": "not_found"
}
}
Get an invoice by invoice_id
Example: returns invoice by given id
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/sales_invoices/find_by_invoice_id/2024-0001.json?
Response
Status: 200 OK
{
"id": "433546341840324172",
"administration_id": 123,
"contact_id": "433546341776361031",
"contact": {
"id": "433546341776361031",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:32.813Z",
"updated_at": "2024-09-30T07:40:32.813Z",
"version": 1727682032,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/245953c43d963e3195d173f18588371855546edb524f2b20505d73f897e80393/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": "433546341788943946",
"contact_person": {
"id": null,
"contact_id": "433546341776361031",
"administration_id": 123,
"firstname": "Jan",
"lastname": "Janssen",
"phone": "123-456-2346",
"email": "janjanssen@dev.null.moneybird.net",
"department": "Sales",
"created_at": "2024-09-30T07:40:32.825Z",
"updated_at": "2024-09-30T07:40:32.825Z",
"version": 1727682032
},
"invoice_id": "2024-0001",
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": null,
"state": "open",
"invoice_date": "2024-09-30",
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": "RF220000000000000ASKNSADW",
"short_payment_reference": "RF22ASKNSADW",
"reference": "Project X",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": "2024-09-30",
"created_at": "2024-09-30T07:40:32.875Z",
"updated_at": "2024-09-30T07:40:32.984Z",
"public_view_code": "765869",
"public_view_code_expires_at": "2024-12-30T07:40:32.937Z",
"version": 1727682032,
"details": [
{
"id": "433546341843469901",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "1 x",
"amount_decimal": "1.0",
"description": "Project X",
"price": "300.0",
"period": null,
"row_order": 1,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:32.878Z",
"updated_at": "2024-09-30T07:40:32.982Z"
}
],
"payments": [
],
"total_paid": "0.0",
"total_unpaid": "363.0",
"total_unpaid_base": "363.0",
"prices_are_incl_tax": false,
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": "2024-10-14",
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/55c79860fe5fd4610af4c9ffc89c6e114f36f239db201fc5f3e405fc21d6def0/245953c43d963e3195d173f18588371855546edb524f2b20505d73f897e80393",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/55c79860fe5fd4610af4c9ffc89c6e114f36f239db201fc5f3e405fc21d6def0/245953c43d963e3195d173f18588371855546edb524f2b20505d73f897e80393/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:32.882Z",
"updated_at": "2024-09-30T07:40:32.882Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_state_changed_to_open",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:32.954Z",
"updated_at": "2024-09-30T07:40:32.954Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_send_email",
"link_entity_id": null,
"link_entity_type": null,
"data": {
"email_address": "info@example.com; janjanssen@dev.null.moneybird.net",
"email_message": "Geachte Jan Janssen,\n\nIn de bijlage kunt u factuur 2024-0001 voor onze diensten vinden. Wij verzoeken u vriendelijk de factuur voor 14-10-2024 te voldoen.\n\nMet vriendelijke groet,\n\nParkietje B.V."
},
"created_at": "2024-09-30T07:40:33.000Z",
"updated_at": "2024-09-30T07:40:33.000Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "300.0",
"taxable_amount_base": "300.0",
"tax_amount": "63.0",
"tax_amount_base": "63.0"
}
]
}
Example: returns 404 when the given invoice_id does not exist
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/sales_invoices/find_by_invoice_id/1337.json?
Response
Status: 404 Not Found
{
"error": "Sales invoice with invoice_id: 1337 was not found",
"symbolic": {
"invoice_id": "not_found"
}
}
Get an invoice by reference
Example: returns invoice by given reference
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/sales_invoices/find_by_reference/invoice-123.json?
Response
Status: 200 OK
{
"id": "433546342473664104",
"administration_id": 123,
"contact_id": "433546342421235299",
"contact": {
"id": "433546342421235299",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:33.429Z",
"updated_at": "2024-09-30T07:40:33.429Z",
"version": 1727682033,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/3c4117343867dbb807bd7d1228a8c0324d8a2feaa2837e25f577d9bace8cf25c/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": "433546342431721062",
"contact_person": {
"id": null,
"contact_id": "433546342421235299",
"administration_id": 123,
"firstname": "Jan",
"lastname": "Janssen",
"phone": "123-456-2346",
"email": "janjanssen@dev.null.moneybird.net",
"department": "Sales",
"created_at": "2024-09-30T07:40:33.438Z",
"updated_at": "2024-09-30T07:40:33.438Z",
"version": 1727682033
},
"invoice_id": "2024-0001",
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": null,
"state": "open",
"invoice_date": "2024-09-30",
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": "RF450000000000000EHTQ9PSC",
"short_payment_reference": "RF45EHTQ9PSC",
"reference": "invoice-123",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": "2024-09-30",
"created_at": "2024-09-30T07:40:33.479Z",
"updated_at": "2024-09-30T07:40:33.580Z",
"public_view_code": "603800",
"public_view_code_expires_at": "2024-12-30T07:40:33.535Z",
"version": 1727682033,
"details": [
{
"id": "433546342475761257",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "1 x",
"amount_decimal": "1.0",
"description": "Project X",
"price": "300.0",
"period": null,
"row_order": 1,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:33.481Z",
"updated_at": "2024-09-30T07:40:33.578Z"
}
],
"payments": [
],
"total_paid": "0.0",
"total_unpaid": "363.0",
"total_unpaid_base": "363.0",
"prices_are_incl_tax": false,
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": "2024-10-14",
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/7e716515f04ce2eb6a63159f2254aa65c32bdcfed726ae26d6d99df62eb942eb/3c4117343867dbb807bd7d1228a8c0324d8a2feaa2837e25f577d9bace8cf25c",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/7e716515f04ce2eb6a63159f2254aa65c32bdcfed726ae26d6d99df62eb942eb/3c4117343867dbb807bd7d1228a8c0324d8a2feaa2837e25f577d9bace8cf25c/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:33.484Z",
"updated_at": "2024-09-30T07:40:33.484Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_state_changed_to_open",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:33.551Z",
"updated_at": "2024-09-30T07:40:33.551Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_send_email",
"link_entity_id": null,
"link_entity_type": null,
"data": {
"email_address": "info@example.com; janjanssen@dev.null.moneybird.net",
"email_message": "Geachte Jan Janssen,\n\nIn de bijlage kunt u factuur 2024-0001 voor onze diensten vinden. Wij verzoeken u vriendelijk de factuur voor 14-10-2024 te voldoen.\n\nMet vriendelijke groet,\n\nParkietje B.V."
},
"created_at": "2024-09-30T07:40:33.595Z",
"updated_at": "2024-09-30T07:40:33.595Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "300.0",
"taxable_amount_base": "300.0",
"tax_amount": "63.0",
"tax_amount_base": "63.0"
}
]
}
Example: returns 404 when the given reference does not exist
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/sales_invoices/find_by_reference/1337.json?
Response
Status: 404 Not Found
{
"error": "Sales invoice with reference: 1337 was not found",
"symbolic": {
"reference": "not_found"
}
}
Download sales invoice PDF by id
Redirects to the download URL of the sales invoice as PDF. The link is valid for 30 seconds.
Parameters
| Parameter | Type | Description |
|---|---|---|
media |
String |
In case you want to hide sender address and logo you can set this to ‘stationery’. |
Example: returns invoice by given id as PDF
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/sales_invoices/433546337587299842/download_pdf.json?
Response
Status: 302 Found
"This resource has been moved temporarily to https://storage.moneybird.dev/1f5abb851a9162ea1a6a73825d4623b19744589b33a376b03b1e12afc87b9f32/7bfe4f276bd613b7f5d1a76f551bc9b71de7b78a1b9651d3badebc7f6664393e/download."
Example: returns 404 when invoice does not exist
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/sales_invoices/1234321/download_pdf.json?
Response
Status: 404 Not Found
{
"error": "record not found",
"symbolic": {
"id": "not_found"
}
}
Download sales invoice UBL by id
Download the sales invoice as UBL.
Example: returns invoice by given id as UBL
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/sales_invoices/433546339455862298/download_ubl.json?
Response
Status: 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<Invoice xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2" xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2 UBL-Invoice-2.1.xsd" xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2">
<cbc:UBLVersionID>2.1</cbc:UBLVersionID>
<cbc:ID>2019-0001</cbc:ID>
<cbc:IssueDate>2019-10-01</cbc:IssueDate>
<cbc:DueDate>2019-10-15</cbc:DueDate>
<cbc:InvoiceTypeCode listID="UNCL1001" listAgencyID="6">380</cbc:InvoiceTypeCode>
<cbc:DocumentCurrencyCode listID="ISO4217" listAgencyID="6">EUR</cbc:DocumentCurrencyCode>
<cac:OrderReference>
<cbc:ID>Project X</cbc:ID>
</cac:OrderReference>
<cac:AdditionalDocumentReference>
<cbc:ID>2019-0001.pdf</cbc:ID>
<cbc:DocumentType>PrimaryImage</cbc:DocumentType>
<cac:Attachment>
<cbc:EmbeddedDocumentBinaryObject mimeCode="application/pdf" filename="2019-0001.pdf">JVBERi0xLjMK/////woxIDAgb2JqCjw8IC9DcmVhdG9yIChQcmF3bikKL1By
b2R1Y2VyIChQcmF3bikKPj4KZW5kb2JqCjIgMCBvYmoKPDwgL0tpZHMgWzUg
MCBSXQovVHlwZSAvUGFnZXMKL0NvdW50IDEKPj4KZW5kb2JqCjMgMCBvYmoK
PDwgL1BhZ2VzIDIgMCBSCi9UeXBlIC9DYXRhbG9nCj4+CmVuZG9iago0IDAg
b2JqCjw8IC9MZW5ndGggMzg4Nwo+PgpzdHJlYW0KMC4wMDAgMC4wMDAgMC4w
MDAgcmcKMC4wMDAgMC4wMDAgMC4wMDAgUkcKcQpCVAoxLjAwMCAwLjAwMCAt
MC4wMDAgMS4wMDAgNDA5LjI4MCA4MTUuODkwIFRtCjAgLTUuNzQ0IFRkCjAu
MDAwIDAuMDAwIDAuMDAwIHJnCjAgVHMKL0YxLjAgOCBUZgpbPDU1NzcyMDQy
NjU2NDcyPiAtMTUgPDY5NmE2NjczMmQ0ZTYxNjE2ZDIwNDI+IDIwIDwyZTU2
PiAxMjUgPDJlPl0gVEoKMCAtOS4yNDggVGQKWzw0NzcyNmY3NDY1MjA0ZDYx
NzI+IC0xNSA8NmI3NDIwMzEzMDMwPl0gVEoKMCAtOS4yNDggVGQKWzwzMTMx
MzIzMjIwNDE0MTIwNDU2ZTczNjM2ODY1NjQ2NT5dIFRKCjAgLTkuMjQ4IFRk
CjAgLTkuMjQ4IFRkCls8NmI3NjZiMmU+IDYwIDwyMDMxMzIzMzM0MzUzOTM4
MzczNj5dIFRKCjAgLTkuMjQ4IFRkCls8NjI3NDc3PiA2MCA8MmU+IDYwIDwy
MDM4MzIzMzM5MzMzNjM1MzMzOD5dIFRKCjAgLTkuMjQ4IFRkCjAgLTkuMjQ4
IFRkCi9GMi4wIDggVGYKWzw0NTJkNmQ2MTY5NmMzYT5dIFRKCi9GMS4wIDgg
VGYKWzwyMDY5NmU2Nj4gMzAgPDZmNDA3NTc3NjI2NTY0NzI+IC0xNSA8Njk2
YTY2NzMyZDJkNmU2MTYxNmQyZTZlNmM+XSBUSgpFVAoKcQoyMDAuMDAwIDAg
MCA4MC4wMDAgMzYuMDAwIDczNS44OTAgY20KL0kxIERvClEKCkJUCjY2IDY5
OS40MjggVGQKL0YxLjAgOSBUZgpbPDQyNmY2ZjZiNzM2ODZmNzAwYT5dIFRK
CkVUCgoKQlQKNjYgNjg5LjAyNCBUZAovRjEuMCA5IFRmCls8NTQ+IDEyMCA8
MmU2MTJlNzY+IDgwIDwyZT4gNjAgPDIwNGE2ZjczMjA3Nj4gMjUgPDYxNmUy
MDY0NjU3MjIwNGQ2ZjZjNjU2ZTBhPl0gVEoKRVQKCgpCVAo2NiA2NzguNjIg
VGQKL0YxLjAgOSBUZgpbPDRmNzg2Nj4gMzAgPDZmNzI2NDBhPl0gVEoKRVQK
CgpCVAo2NiA2NjguMjE2IFRkCi9GMS4wIDkgVGYKWzwwYT5dIFRKCkVUCgoK
QlQKNjYgNjU3LjgxMiBUZAovRjEuMCA5IFRmCls8MGE+XSBUSgpFVAoKCkJU
CjM2IDU4MC45NDYgVGQKL0YxLjAgMTggVGYKWzw0Nj4gNTAgPDYxNjM3NDc1
NzU3MjIwMzIzMDMxMzAyZDMwMzEzMTMyPl0gVEoKRVQKCgpCVAo0MDguNjQg
NTkxLjk3MiBUZAovRjEuMCA5IFRmCls8NDY+IDUwIDw2MTYzNzQ3NTc1NzI2
NDYxNzQ3NTZkM2E+IDUwIDwyMD5dIFRKCkVUCgowLjAwMCAwLjAwMCAwLjAw
MCByZwoKQlQKNTA1LjYxNCA1OTEuOTcyIFRkCi9GMS4wIDkgVGYKWzwzMTM4
MmQzMDM5MmQzMjMwMzEzMD5dIFRKCkVUCgowLjAwMCAwLjAwMCAwLjAwMCBy
ZwoKQlQKNDA4LjY0IDU3OC4xIFRkCi9GMS4wIDkgVGYKWzw1Nj4gODAgPDY1
NzI+IC0zMCA8NzY+IDI1IDw2MTZjNjQ2MTc0NzU2ZDNhPiA1MCA8MjA+XSBU
SgpFVAoKMC4wMDAgMC4wMDAgMC4wMDAgcmcKCkJUCjUwNS42MTQgNTc4LjEg
VGQKL0YxLjAgOSBUZgpbPDMwMzIyZDMxMzAyZDMyMzAzMTMwPl0gVEoKRVQK
CjAuMDAwIDAuMDAwIDAuMDAwIHJnCjAuNSB3CjAuMDAwIDAuMDAwIDAuMDAw
IFJHCjEgdwowLjAwMCAwLjAwMCAwLjAwMCBSRwowLjUgdwowLjAwMCAwLjAw
MCAwLjAwMCByZwoxIHcKMC4wMDAgMC4wMDAgMC4wMDAgUkcKMC41IHcKCkJU
Cjk2IDUzMC4wMjQgVGQKL0YyLjAgOSBUZgpbPDRmNmQ3MzYzPiAxMCA8Njg3
MjY5NmE3NjY5NmU2Nz5dIFRKCkVUCgowLjAwMCAwLjAwMCAwLjAwMCByZwox
IHcKMC4wMDAgMC4wMDAgMC4wMDAgUkcKMC41IHcKCkJUCjM4NC41NjUgNTMw
LjAyNCBUZAovRjIuMCA5IFRmCls8NDI2NTY0NzI2MT4gMTAgPDY3Pl0gVEoK
RVQKCjAuMDAwIDAuMDAwIDAuMDAwIHJnCjEgdwowLjAwMCAwLjAwMCAwLjAw
MCBSRwowLjUgdwoKQlQKNDg5LjY5NSA1MzAuMDI0IFRkCi9GMi4wIDkgVGYK
Wzw1ND4gODAgPDZmNzQ2MTYxNmM+XSBUSgpFVAoKMC4wMDAgMC4wMDAgMC4w
MDAgcmcKMSB3CjAuMDAwIDAuMDAwIDAuMDAwIFJHCjAuNSB3CgpCVAo1MzQu
OTg3IDUzMC4wMjQgVGQKL0YyLjAgOSBUZgpbPDQyNTQ1Nz5dIFRKCkVUCgow
LjAwMCAwLjAwMCAwLjAwMCByZwozNi4wMDAgNTI2LjAzOCBtCjU1OS4yODAg
NTI2LjAzOCBsClMKMSB3CjAuMDAwIDAuMDAwIDAuMDAwIFJHCjAuNSB3CgpC
VAo0MCA1MTIuOTQ4IFRkCi9GMS4wIDkgVGYKWzwzMTIwNzg+XSBUSgpFVAoK
MC4wMDAgMC4wMDAgMC4wMDAgcmcKMSB3CjAuMDAwIDAuMDAwIDAuMDAwIFJH
CjAuNSB3CgpCVAo5NiA1MTIuOTQ4IFRkCi9GMS4wIDkgVGYKWzw3NDY1NzM3
ND5dIFRKCkVUCgowLjAwMCAwLjAwMCAwLjAwMCByZwoxIHcKMC4wMDAgMC4w
MDAgMC4wMDAgUkcKMC41IHcKCkJUCjM3Mi45NDYgNTEyLjk0OCBUZAovRjEu
MCA5IFRmCls8ODAyMDMxMmUzMjMzMzQyYzMwMzA+XSBUSgpFVAoKMC4wMDAg
MC4wMDAgMC4wMDAgcmcKMSB3CjAuMDAwIDAuMDAwIDAuMDAwIFJHCjAuNSB3
CgpCVAo0NzIuOTQ2IDUxMi45NDggVGQKL0YxLjAgOSBUZgpbPDgwMjAzMTJl
MzIzMzM0MmMzMDMwPl0gVEoKRVQKCjAuMDAwIDAuMDAwIDAuMDAwIHJnCjEg
dwowLjAwMCAwLjAwMCAwLjAwMCBSRwowLjUgdwoKQlQKNTM3LjQ3MSA1MTIu
OTQ4IFRkCi9GMS4wIDkgVGYKWzwzMTM5MjU+XSBUSgpFVAoKMC4wMDAgMC4w
MDAgMC4wMDAgcmcKMzYuMDAwIDUwNS42MzQgbQo1NTkuMjgwIDUwNS42MzQg
bApTCjAuMDAwIDAuMDAwIDAuMDAwIFJHCjEgdwowLjAwMCAwLjAwMCAwLjAw
MCBSRwowLjUgdwoKQlQKMzcxLjQ3OSA0OTIuMzQgVGQKL0YyLjAgOSBUZgpb
PDUzNzU2Mjc0NmY3NDYxNjE2YzNhPl0gVEoKRVQKCjAuMDAwIDAuMDAwIDAu
MDAwIHJnCjEgdwowLjAwMCAwLjAwMCAwLjAwMCBSRwowLjUgdwoKQlQKNDcy
Ljk0NiA0OTIuNTQ0IFRkCi9GMS4wIDkgVGYKWzw4MDIwMzEyZTMyMzMzNDJj
MzAzMD5dIFRKCkVUCgowLjAwMCAwLjAwMCAwLjAwMCByZwoxIHcKMC4wMDAg
MC4wMDAgMC4wMDAgUkcKMC41IHcKCkJUCjM3MS40NzkgNDcwLjQ2OCBUZAov
RjIuMCA5IFRmCls8NDI1NDU3MjAzMTM5MjUzYT5dIFRKCkVUCgowLjAwMCAw
LjAwMCAwLjAwMCByZwoxIHcKMC4wMDAgMC4wMDAgMC4wMDAgUkcKMC41IHcK
CkJUCjQ4MC40NTIgNDcwLjY3MiBUZAovRjEuMCA5IFRmCls8ODAyMDMyMzMz
NDJjMzQzNj5dIFRKCkVUCgowLjAwMCAwLjAwMCAwLjAwMCByZwozMTkuNDgw
IDQ2MS44OTAgbQo1MTkuNDgwIDQ2MS44OTAgbApTCjEgdwowLjAwMCAwLjAw
MCAwLjAwMCBSRwowLjUgdwoKQlQKMzg2LjY5OCA0NDguNTk2IFRkCi9GMi4w
IDkgVGYKWzw1ND4gODAgPDZmNzQ2MTYxNmMzYT5dIFRKCkVUCgowLjAwMCAw
LjAwMCAwLjAwMCByZwoxIHcKMC4wMDAgMC4wMDAgMC4wMDAgUkcKMC41IHcK
CkJUCjQ3Mi45NDYgNDQ4LjggVGQKL0YxLjAgOSBUZgpbPDgwMjAzMTJlMzQz
NjM4MmMzNDM2Pl0gVEoKRVQKCjAuMDAwIDAuMDAwIDAuMDAwIHJnCjM2LjAw
MCA2My43NDQgbQo1NTkuMjgwIDYzLjc0NCBsClMKCkJUCjM2IDUyLjI4MiBU
ZAovRjEuMCA5IFRmCls8NTc+IDMwIDw2NTIwNzY+IDI1IDw2NTcyN2E+IDE1
IDw2ZjY1NmI+IDIwIDw2NTZlMjA3NTIwNzY3Mj4gLTE1IDw2OTY1NmU2NDY1
NmM2OTZhNmIyMDY4NjU3NDIwNjI2Zj4gMTUgPDc2PiAyNSA8NjU2ZTczNzQ2
MTYxNmU2NDY1MjA2MjY1NjQ3Mj4gMTAgPDYxNjcyMDYyNjk2ZTZlNjU2ZTIw
NjQ2NTIwNjc2NTczNzQ2NTZjNjQ2NTIwNjI2NTc0NjE2YzY5NmU2NzczNzQ2
NTcyPiAtMjUgPDZkNjk2YTZlMjA3NDY1MjA3Nj4gMjUgPDZmNmM2NDZmNjU2
ZTIwNmY3MDIwNmY2ZTdhPiAxNSA8NjUyMDYyNjE2ZTZiNzI2NTZiPiAyMCA8
NjU2ZTY5NmU2NzJlPiA2MCA8MjA+IDUwIDw1Nj4gODAgPDZmNmY3MjBhPl0g
VEoKRVQKCgpCVAozNiA0MS44NzggVGQKL0YxLjAgOSBUZgpbPDc2NzI+IDEw
IDw2MTY3NjU2ZTIwNmI3NTZlNzQyMDc1MjA2MzZmNmU3NDYxNjM3NDIwNmY3
MDZlNjU2ZDY1NmUyMDcwNjU3MjIwNjUyZDZkNjE2OTZjMmU+XSBUSgpFVAoK
UQoKZW5kc3RyZWFtCmVuZG9iago1IDAgb2JqCjw8IC9Db250ZW50cyA0IDAg
UgovUHJvY1NldCA2IDAgUgovTWVkaWFCb3ggWzAgMCA1OTUuMjggODQxLjg5
XQovUGFyZW50IDIgMCBSCi9SZXNvdXJjZXMgPDwgL0ZvbnQgPDwgL0YxLjAg
NyAwIFIKL0YyLjAgOCAwIFIKPj4KL1hPYmplY3QgPDwgL0kxIDkgMCBSCj4+
Cj4+Ci9UeXBlIC9QYWdlCj4+CmVuZG9iago2IDAgb2JqClsvUERGIC9UZXh0
IC9JbWFnZUNdCmVuZG9iago3IDAgb2JqCjw8IC9CYXNlRm9udCAvSGVsdmV0
aWNhCi9FbmNvZGluZyAvV2luQW5zaUVuY29kaW5nCi9UeXBlIC9Gb250Ci9T
dWJ0eXBlIC9UeXBlMQo+PgplbmRvYmoKOCAwIG9iago8PCAvQmFzZUZvbnQg
L0hlbHZldGljYS1Cb2xkCi9FbmNvZGluZyAvV2luQW5zaUVuY29kaW5nCi9U
eXBlIC9Gb250Ci9TdWJ0eXBlIC9UeXBlMQo+PgplbmRvYmoKOSAwIG9iago8
PCAvTGVuZ3RoIDM3MjkKL1dpZHRoIDIwMAovQ29sb3JTcGFjZSAvRGV2aWNl
R3JheQovRmlsdGVyIC9EQ1REZWNvZGUKL0hlaWdodCA4MAovVHlwZSAvWE9i
amVjdAovQml0c1BlckNvbXBvbmVudCA4Ci9TdWJ0eXBlIC9JbWFnZQo+Pgpz
dHJlYW0K/9j/4AAQSkZJRgABAQEASABIAAD/2wBDAAEBAQEBAQEBAQEBAQEB
AQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEB
AQEBAQH/wAALCABQAMgBAREA/8QAHAABAAIDAQEBAAAAAAAAAAAAAAgJBgcK
AgUD/8QALBAAAQQDAQABBAIBAwUAAAAABAMFBgcAAggBCRITFBURFhcKGSIh
Q1mX2P/aAAgBAQAAPwDv4xjGMYxjGMYxjGMYxjGMYxjGMYxjGMYxjGMYxjGM
YxjGMhd0p2/WvP8AIWepo8xya+unZkFuXX3MtQpCPVkPQ+30ppSOXrrrpMNU
1wOqpqo7WLYR7KwCBJGrNv7kwJRv2rptu8/lblFm8yc5SWEe8avdv288qvPU
HO7XA+nafErhCo7GmA1ZytK4oOsvCrSZpS1RVjLPLYAo7O9x3t2hD/qCOoyK
2LfHVa9hXnw9zJbtryH2W2PP6sY5DMpL60sbD69PZW5WhR/rPGm1nYW71b7W
nvorU1ghp/8AaQ1/6/zNHGMYxjGMYxjGMYxjGMoX7s707GQniVK88cr9XV/V
JBZjbPOsI/TcSk1hmgi+e6mA89Vnac7ruPJEmebJCJ2RYbirsz6krHNdcuKi
DY5k/B5q6yojlKPvDXVnxpfJWtJped49WXa02gtETS4rak2317ESazbHeunV
pBKHRZdQhdEZVcdjZ9iSB4+ztASn4vkl/wDdpG/8efyO/wDq7n7/AOm8rJiP
TN7crT5p34G4q76cqGkUg9UmHF9+Q6sla+imjoSsW6PnNFmR+97DnNTlblqK
GbVgdF5jW7iWe4rtokUU2H3R6Wagsr226+YJ0rArHrAx3G+pxgVsRZeIzmMO
CfnnhLY8tuyxreRuhtt54m5sTo8MZunv1guZH0q6p7MxjGMYxjGMYxjGMYxn
Pt84DVCSZHQknnFbQG2BKv5m+Rq2mCGWcyryGFGzCvapqmQxkl7aBXBqJMFF
chdN1Eh3IJbdPZTVMlLbbzfWt/4IIJyt8kwvUa3QXCPGrZvTZFLpRP8AxrVT
zHNV9bATtXd8/c+PUzk/5nqfsLaP1/o3oP4/ihv3vCfvJfYlp8yPK3EvBPGh
d+0lwxyg4TdCzoLD9B59W576wetUk/cfsN9gGmSx4v0zX8BD8Zbxx8TT/lT6
0Vfq8+mJnBcWo+4ub+C+wg+YeeaavAv5Sa4q5aQUlBnCHj7Q5uFfiPwPEXSR
SQz+TlvsqH7en+pL7Cje6Ipfb9+rskVU+0kor9Cin2091Ptpa/Wqp9Gvu30J
6fz59Sm38fTpr/Pn1be+efz5/P8AOQOrj5LuP7So2/Oh4zYziNXPMTjJGe7f
ZNDpXFJVCnaLtiTme2FQ5/aQJEWcX939WzIAAE7PL+iUwt/q7sIUIjJihbvg
nSNRQe8awUfSa9sdp9f4efI467xRzdWPcskUN3/QvwwTuIA6eDbGtK5giHjm
1LBuofireaIQtt3GMre6v+WTh/jWfC1LbloOLjbpIqB6tXVrDpLY8yawCRP2
CBT+JGm8puj+6zd7o5jtr05gvJbUqm6htpDbt+V5MKg70rnpen4LelSObi8V
1YrWu7xhxdmF6jDiQKK5GtBXhTJIAm91D3QcW40fz1cXxAvRLQ0BYtvIFLX2
/jGMYxjGMYxlb/Sjc3u/yEfHi1uoIbm2OFdd0huDa4CoGgHCEQqlklxTAyU1
RyRl09tk1kFk90ldNttN9NtfffM+r289yTnWkY2XzH5BKWntpdH8vUrvMW+t
Iw9BtTbb12xKtHB5Mi3ujSDIiGVrlriW3CGmDfwtsomiWJ6vut5inLjld0k6
C675n6qsuFdMs1Nx3mSYQ57KpKI14MkvbDdbxb2MdGAXKTgmqh7w5p1BOXN3
VR8/I9RTQ++p5t+/dsajkUG4SaYswMkbavPka51I8bGBqBZ2/wAIWb7A+8v4
G3IDDeLK/Rr91X7X17/Tr9e3v0+ZZfnHp8iXHKCXy013zBCJodB+efljdINY
vU8BZ/CkP30goCTSKcSQgAlInX8Aqb/gquKTgl9SoMskD66KIqDbIDbbAlEo
vHq/pn5Q4I2dkXLw5VXxg1s1NnOdTUFMW+qYgSDEopNfty6ywhRdFZhXoG0D
bVnBoXXDEb2SXx1tbjmoUFJJwwGn/kX6uuScfApL7HtSVwcDoCQ3zCrrEa3V
eFQe7y67sYSv4i9yBnHWDZnU978SbNCBEUkwSpQ6HItLeKG4BN2vm7ezul2+
Q/6g/wAifRVlpNvPWlHpUdszzpzVEqg10tIZhlSEFUHMUTjy5HmhjO7It+yO
yfqS4C2ifqWyWt4fxP1/e4/OMV6K6A6dsPoOX9aVlS10jx2U7EDw2mm2Rwna
RNsNrtpUczkgxvWWUM4cmcvERzZG9MX7pzVNLJ2X8ri+DN4hCXV3yot9uFNI
fabt1tNlXwCVbhjzsyrRnmQkNyMPTcPfHMmKhvX7ZZwHj2yrQO0awlZfXVt8
j2+bH7gta4uivlQ5z+OGJdK2nytREsoORXfJpxz5Lm6B2xbEpFcbBQTjEQsP
wFxJaxmXyDFKEitqZaZO6Ev3eWw9QFt3bqsJ/wDID2fFfjg7zjQvSM9lEx4t
71i1F1R1K2Om4U4sWv8Aaay5rUGkcmb1thpd9wWPCuay5yRShbRJW0RxIcR0
Qt093s8A7ddPkr04HX+UDrbSE9E8oMPSE7nqLm1pzGOyhQR6KXYKe88U/Epe
NqyEfUn8WuvWNTaNbeRgncpZAR+Gis5/If22N8ONdzz3p6es1xVV8sSPMat4
EPqqkkk9aNFGSWxEhrFcnFRTeWs6L89oKugsrKdNHNsj7Ug9Fl6De7eWR+2X
cnxwfKpz9T0h7evzq2g+iudbPte8GK9ZSLYLlXXtdQmyJsXZ0BbWQMUCDQ4n
eBEGtDBHGkcXyPiSdqJLkpA7Qc217RbubqmGXLwZ0vTdh9tuXMnTHTYdOqvP
XnT1Z2ey32wp2MPCp2jH+a4fExkaP1jqh722t8iFfnfdE1Bl0S3LWaRnh93L
M5J2h0bYnzsnNXfXS9Nwz4932dWpVkFreXEMyDqW1Nt0yNriRskEXFk7RAwW
mnl2jSKMjmI1EmSFJ1NHI/Vfhm5qy959O1NHvhz+RS57usBy5vu+JySg+too
o8K6V6rOmkqfxaIWy6xwdMRiCkT+AgrLnQlvGbBtDK3W2U2TRcS91rYPg9kX
RVs8gunTfSljTibSbpe157YsDj0rkTk8Ndb1UI9Ex6LxeLtzh79DQ2EOjdI3
kP0PRFA6Onxn6UE0xEvdrk8YxjIIdc8p3Pedlc+XBQvSTNzjYVCCW82iur9R
oF5N8ja7ebIY1ugu7M5WJABWpVuRiGuyRXu7ruRsf/w0D9F+omPcm4V7ttV2
qwW9PkXglh1zXt5UpdrpCGLh6OQBxlBlKWZGrLaWNKYN1+OpTDo5uEbQCVcd
Gp01FTX2W3bTtU/RVdg2pxp1WZ0tbPQvNXasV5/RuaIVLF5jC5LyqzXbsqrU
IcuDYXIOSO1wwv0TwjSaO+y4SDEn5576j4qUV9pP3TD1+He3J9P6Mf8AoL5B
oTa0Cpa7oReGkCj/ABbHqxPkT7BtXRNuA9mbZer8S0jrIPBqaiv6V0T823TU
3CW9T18y2LI6WByZz9aN7U/0vO4B+9u2hBXsKppr/apq2f1QWRjGCPKX9bZ5
I3xJ9/MHPLT+uSsLwoP936xN0N009tI7dNfFFwX19ZY9v3tRYsisX0FuaXuS
R+YzyBEzJlatk9gWmbjwWTR4OVIIajiDpnOw5D0mAA3tiTom2giiJZX0P8a3
FHUVSVlR9uUZHza4pbVJGpGaKHvkBXrwLUMJuKaoy5QtzYzxGZ1b28IV4Z1l
yGxz3Cb3EsVR3a2twCwyL/Ej8eEJhFzVvEOb2mNQfoSKwCFW/HGSe2y3AS+P
VisIVDh/fRZ4muwnhnBJObu/RlZlfpY7qnO8uc3xzcnEsqdNcV9EKkryB1VX
zR/X4DWUMi9fQhh/PdHX9JEIYxgxyNNH7R7Ncnpy/WsraEF+e7uJ7oZ9n8g8
0otRVdSDfV3xPcEdpy3/ACFflCtT5Yu6Agpc/i8ilkBlTsKAgmIGhIToY9sq
Mm/FCRQBDIkQroWACOgIAQMOlonr4s74muBbbqGoqRmFEIKQqg24pnpoprnV
jtc2gDSabu4mNTZYg8t/vDm1kmKKEKNcjfntu8X+2SmKmSMKshlBfxj8Lmcv
IcZ70CyC84JSICXr18zymfx1d1lraogoNJ3+aR6WNc+kD/t6KIkW6PUoOLOF
DCBMUXCCEHR2yJx3zkD0Qw9XC119q/oxWI9Nsc9/t063/BrcXwnxCOf1ZST7
wsn7fhZHn7guOEP233P+bpt9On01CfIx8ODDMeOYNzPwVVkYibWt3LGep7Rj
MrsqYFgPXilWziATZ5GerBfpY4aODiOVDm9GOt5rez6ojEliCiL7Gqk2Hc6/
FlwlyvMJhPqcohqbJfNmRyijo+SuSzKxSwYW7DJBnwqPeT+QyRGPxokJL8Ak
JqSGXNbNv1J5RTWkOGjqKF/B78YsBkbHLI9zbsk/RSxmm0oaaRbN1LaQ6UsL
im7s+kdD1sRIIRiEdUkz1o8uMU0Oy6AWr4K5otjUkFKRj4L5Pja/WpLNVP4a
/dALk3dT7/3mySP8pBu7bNmhxR+guYr6Qj8hvsaZD/crrWIqo/ufuoKJLt7U
qDWR8gXxtW9cVJ82fG1yHX1ZVTwwG86yO17MlMnepjN6nFisv9kjfH4G3TCS
PEufnaTqyKQHiOKi7n4oqMTHniRRJgM/h0u/rSu4nUVdQSqoG16MsJraHxuC
xFpT2+vVujkUaBGNmD9U9812W3QbwR9FV9/PuLq+brKe+777e5m+MYxjGMYx
jGMYxjGMYxjGMYxjGMYxjGMYxjGMYxjGMYxjGMYxjGMYxjGMYxjGMYxjP//Z
CmVuZHN0cmVhbQplbmRvYmoKeHJlZgowIDEwCjAwMDAwMDAwMDAgNjU1MzUg
ZiAKMDAwMDAwMDAxNCAwMDAwMCBuIAowMDAwMDAwMDcwIDAwMDAwIG4gCjAw
MDAwMDAxMjcgMDAwMDAgbiAKMDAwMDAwMDE3NiAwMDAwMCBuIAowMDAwMDA0
MTE1IDAwMDAwIG4gCjAwMDAwMDQzMDEgMDAwMDAgbiAKMDAwMDAwNDMzNyAw
MDAwMCBuIAowMDAwMDA0NDM0IDAwMDAwIG4gCjAwMDAwMDQ1MzYgMDAwMDAg
biAKdHJhaWxlcgo8PCAvUm9vdCAzIDAgUgovU2l6ZSAxMAovSW5mbyAxIDAg
Ugo+PgpzdGFydHhyZWYKODQzMwolJUVPRgo=
</cbc:EmbeddedDocumentBinaryObject>
</cac:Attachment>
</cac:AdditionalDocumentReference>
<cac:AccountingSupplierParty>
<cac:Party>
<cbc:EndpointID schemeID="0106">08155914</cbc:EndpointID>
<cac:PartyName>
<cbc:Name>Parkietje B.V.</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:StreetName>Brouwerijstraat 26</cbc:StreetName>
<cbc:CityName>Enschede</cbc:CityName>
<cbc:PostalZone>7523XD</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode listID="ISO3166-1:Alpha2" listAgencyID="6">NL</cbc:IdentificationCode>
</cac:Country>
</cac:PostalAddress>
<cac:PartyTaxScheme>
<cbc:CompanyID schemeID="NL:VAT">NL817575546B01</cbc:CompanyID>
<cac:TaxScheme>
<cbc:ID schemeID="UN/ECE 5153">VAT</cbc:ID>
</cac:TaxScheme>
</cac:PartyTaxScheme>
<cac:PartyLegalEntity>
<cbc:RegistrationName>Parkietje B.V.</cbc:RegistrationName>
<cbc:CompanyID schemeID="0106">08155914</cbc:CompanyID>
</cac:PartyLegalEntity>
<cac:Contact>
<cbc:ElectronicMail>info@dev.null.moneybird.net</cbc:ElectronicMail>
</cac:Contact>
</cac:Party>
</cac:AccountingSupplierParty>
<cac:AccountingCustomerParty>
<cac:Party>
<cac:PartyName>
<cbc:Name>Foobar Holding B.V.</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:StreetName>Hoofdstraat 12</cbc:StreetName>
<cbc:CityName>Amsterdam</cbc:CityName>
<cbc:PostalZone>1234AB</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode listID="ISO3166-1:Alpha2" listAgencyID="6">NL</cbc:IdentificationCode>
</cac:Country>
</cac:PostalAddress>
<cac:PartyLegalEntity>
<cbc:RegistrationName>Foobar Holding B.V.</cbc:RegistrationName>
</cac:PartyLegalEntity>
<cac:Contact>
<cbc:ElectronicMail>info@example.com</cbc:ElectronicMail>
</cac:Contact>
</cac:Party>
</cac:AccountingCustomerParty>
<cac:PaymentMeans>
<cbc:PaymentMeansCode listID="UNCL4461" listAgencyID="6">30</cbc:PaymentMeansCode>
<cbc:PaymentDueDate>2019-10-15</cbc:PaymentDueDate>
<cbc:PaymentID>RF050000000000000V4QN4RNG</cbc:PaymentID>
<cac:PayeeFinancialAccount>
<cbc:ID schemeID="IBAN">NL50TEST0166567191</cbc:ID>
<cac:FinancialInstitutionBranch>
<cac:FinancialInstitution>
<cbc:ID schemeID="BIC">TESTNL00</cbc:ID>
</cac:FinancialInstitution>
</cac:FinancialInstitutionBranch>
</cac:PayeeFinancialAccount>
</cac:PaymentMeans>
<cac:PaymentTerms>
<cbc:Note>We verzoeken u vriendelijk het bovenstaande bedrag van € 363,00 voor 15-10-2019 te voldoen op onze bankrekening onder vermelding van de omschrijving RF05V4QN4RNG. Voor vragen kunt u contact opnemen per e-mail.</cbc:Note>
</cac:PaymentTerms>
<cac:TaxTotal>
<cbc:TaxAmount currencyID="EUR">63.0</cbc:TaxAmount>
<cac:TaxSubtotal>
<cbc:TaxableAmount currencyID="EUR">300.0</cbc:TaxableAmount>
<cbc:TaxAmount currencyID="EUR">63.0</cbc:TaxAmount>
<cac:TaxCategory>
<cbc:ID schemeID="UNCL5305">S</cbc:ID>
<cbc:Percent>21.0</cbc:Percent>
<cac:TaxScheme>
<cbc:ID schemeID="UN/ECE 5153">VAT</cbc:ID>
</cac:TaxScheme>
</cac:TaxCategory>
</cac:TaxSubtotal>
</cac:TaxTotal>
<cac:LegalMonetaryTotal>
<cbc:LineExtensionAmount currencyID="EUR">300.0</cbc:LineExtensionAmount>
<cbc:TaxExclusiveAmount currencyID="EUR">300.0</cbc:TaxExclusiveAmount>
<cbc:TaxInclusiveAmount currencyID="EUR">363.0</cbc:TaxInclusiveAmount>
<cbc:AllowanceTotalAmount currencyID="EUR">0</cbc:AllowanceTotalAmount>
<cbc:PayableAmount currencyID="EUR">363.0</cbc:PayableAmount>
</cac:LegalMonetaryTotal>
<cac:InvoiceLine>
<cbc:ID>1</cbc:ID>
<cbc:InvoicedQuantity unitCode="ZZ" unitCodeListID="UNECERec20">1.0</cbc:InvoicedQuantity>
<cbc:LineExtensionAmount currencyID="EUR">300.0</cbc:LineExtensionAmount>
<cac:Item>
<cbc:Description>Project X</cbc:Description>
<cbc:Name>Project X</cbc:Name>
<cac:ClassifiedTaxCategory>
<cbc:ID schemeID="UNCL5305">S</cbc:ID>
<cbc:Percent>21.0</cbc:Percent>
<cac:TaxScheme>
<cbc:ID schemeID="UN/ECE 5153">VAT</cbc:ID>
</cac:TaxScheme>
</cac:ClassifiedTaxCategory>
</cac:Item>
<cac:Price>
<cbc:PriceAmount currencyID="EUR">300.0</cbc:PriceAmount>
</cac:Price>
</cac:InvoiceLine>
</Invoice>
Example: returns 404 when invoice does not exist
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/sales_invoices/1234321/download_ubl.json?
Response
Status: 404 Not Found
{
"error": "record not found",
"symbolic": {
"id": "not_found"
}
}
Download sales invoice packing slip PDF by id
Redirects to the download URL of the sales invoice as packing slip PDF. The link is valid for 30 seconds.
Parameters
| Parameter | Type | Description |
|---|---|---|
media |
String |
In case you want to hide sender address and logo you can set this to ‘stationery’. |
Example: returns invoice by given id as packing slip PDF
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/sales_invoices/433546340051453490/download_packing_slip_pdf.json?
Response
Status: 302 Found
"This resource has been moved temporarily to https://storage.moneybird.dev/870482099e3686fd116ecf19bb13e4e17774fc7202e5897ceb0bbdad983cbdee/98b9df5500e3eedda292656f431604314767709e5cf9d0854a97d297cdf83075/download."
Example: returns 404 when invoice does not exist
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/sales_invoices/1234321/download_packing_slip_pdf.json?
Response
Status: 404 Not Found
{
"error": "record not found",
"symbolic": {
"id": "not_found"
}
}
Create a sales invoice
Parameters
| Parameter | Type | Description |
|---|---|---|
sales_invoice[contact_id] |
Integer |
Should be a valid contact id. |
sales_invoice[contact_person_id] |
Integer |
Should be a valid contact person id. |
sales_invoice[original_estimate_id] |
Integer |
|
sales_invoice[document_style_id] |
Integer |
Default document style is used if value is not provided. Should be a valid document style id. |
sales_invoice[workflow_id] |
Integer |
If value is not provided, the workflow saved in the contact is used. If the contact doesn’t have a default workflow, the administration’s default workflow is used. Should be a valid workflow id. |
sales_invoice[reference] |
String |
|
sales_invoice[invoice_sequence_id] |
String |
|
sales_invoice[invoice_date] |
String |
|
sales_invoice[first_due_interval] |
Integer |
|
sales_invoice[currency] |
String |
ISO three-character currency code, e.g. EUR or USD. |
sales_invoice[prices_are_incl_tax] |
Boolean |
|
sales_invoice[payment_conditions] |
String |
|
sales_invoice[discount] |
Decimal |
Discount percentage, e.g. 10,0%. |
sales_invoice[details_attributes][id] |
Integer |
|
sales_invoice[details_attributes][description] |
String |
|
sales_invoice[details_attributes][period] |
String |
String with a date range: |
sales_invoice[details_attributes][price] |
Decimal |
Both a decimal and a string ‘10,95’ are accepted. |
sales_invoice[details_attributes][amount] |
String |
|
sales_invoice[details_attributes][tax_rate_id] |
Integer |
Should be a valid tax rate id. |
sales_invoice[details_attributes][ledger_account_id] |
Integer |
Should be a valid ledger account id. |
sales_invoice[details_attributes][project_id] |
Integer |
Should be a valid project id. |
sales_invoice[details_attributes][product_id] |
Integer |
Should be a valid product id. |
sales_invoice[details_attributes][time_entry_ids] |
Array[integer] |
|
sales_invoice[details_attributes][trip_ids] |
Array[integer] |
|
sales_invoice[details_attributes][row_order] |
Integer |
|
sales_invoice[details_attributes][_destroy] |
Boolean |
|
sales_invoice[details_attributes][automated_tax_enabled] |
Boolean |
|
sales_invoice[custom_fields_attributes][id] |
Integer |
Required |
sales_invoice[custom_fields_attributes][value] |
String |
Required |
from_checkout |
Boolean |
Example: create a basic sales invoice
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPOST \
-d '{"sales_invoice":{"reference":"30052","contact_id":433546343055623807,"details_attributes":[{"description":"Rocking Chair","price":129.95}]}}' \
https://moneybird.com/api/v2/123/sales_invoices
Response
Status: 201 Created
{
"id": "433546343349225099",
"administration_id": 123,
"contact_id": "433546343055623807",
"contact": {
"id": "433546343055623807",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:34.034Z",
"updated_at": "2024-09-30T07:40:34.034Z",
"version": 1727682034,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/7d0c138f7406dbe81871d7b099f2be4305db864d742de0f39472ab02a4fa5529/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
{
"id": "433546343067158146",
"contact_id": "433546343055623807",
"administration_id": 123,
"firstname": "Jan",
"lastname": "Janssen",
"phone": "123-456-2346",
"email": "janjanssen@dev.null.moneybird.net",
"department": "Sales",
"created_at": "2024-09-30T07:40:34.044Z",
"updated_at": "2024-09-30T07:40:34.044Z",
"version": 1727682034
}
],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"invoice_id": null,
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": 2,
"state": "draft",
"invoice_date": null,
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": null,
"short_payment_reference": null,
"reference": "30052",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": null,
"created_at": "2024-09-30T07:40:34.314Z",
"updated_at": "2024-09-30T07:40:34.328Z",
"public_view_code": null,
"public_view_code_expires_at": null,
"version": 1727682034,
"details": [
{
"id": "433546343357613708",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"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": "2024-09-30T07:40:34.322Z",
"updated_at": "2024-09-30T07:40:34.322Z"
}
],
"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",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": null,
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/3053235fe8f515f9bcd45a19fe91ceefc1a35907bc370d4d59921525b74a3a49/7d0c138f7406dbe81871d7b099f2be4305db864d742de0f39472ab02a4fa5529",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/3053235fe8f515f9bcd45a19fe91ceefc1a35907bc370d4d59921525b74a3a49/7d0c138f7406dbe81871d7b099f2be4305db864d742de0f39472ab02a4fa5529/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:34.332Z",
"updated_at": "2024-09-30T07:40:34.332Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "129.95",
"taxable_amount_base": "129.95",
"tax_amount": "27.29",
"tax_amount_base": "27.29"
}
]
}
Example: create a sales invoice in a foreign currency
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPOST \
-d '{"sales_invoice":{"reference":"30052","contact_id":433546343820035745,"currency":"USD","details_attributes":[{"description":"Rocking Chair","price":159.99,"tax_rate_id":433546344023459501}]}}' \
https://moneybird.com/api/v2/123/sales_invoices
Response
Status: 201 Created
{
"id": "433546344096859822",
"administration_id": 123,
"contact_id": "433546343820035745",
"contact": {
"id": "433546343820035745",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:34.763Z",
"updated_at": "2024-09-30T07:40:34.763Z",
"version": 1727682034,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/66cd373a2bba89540b5717cabad2554958b6b7f428be9c091bcb8a4d318b1e36/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
{
"id": "433546343833667236",
"contact_id": "433546343820035745",
"administration_id": 123,
"firstname": "Jan",
"lastname": "Janssen",
"phone": "123-456-2346",
"email": "janjanssen@dev.null.moneybird.net",
"department": "Sales",
"created_at": "2024-09-30T07:40:34.773Z",
"updated_at": "2024-09-30T07:40:34.773Z",
"version": 1727682034
}
],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"invoice_id": null,
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": 2,
"state": "draft",
"invoice_date": null,
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": null,
"short_payment_reference": null,
"reference": "30052",
"language": "nl",
"currency": "USD",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": null,
"created_at": "2024-09-30T07:40:35.027Z",
"updated_at": "2024-09-30T07:40:35.031Z",
"public_view_code": null,
"public_view_code_expires_at": null,
"version": 1727682035,
"details": [
{
"id": "433546344098956975",
"administration_id": 123,
"tax_rate_id": "433546344023459501",
"ledger_account_id": "433546158461159223",
"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": "2024-09-30T07:40:35.029Z",
"updated_at": "2024-09-30T07:40:35.029Z"
}
],
"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",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": null,
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/ad6b3211647b01a545b41e23f04ef890f604042c3b5d7a76fe27fa619191132f/66cd373a2bba89540b5717cabad2554958b6b7f428be9c091bcb8a4d318b1e36",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/ad6b3211647b01a545b41e23f04ef890f604042c3b5d7a76fe27fa619191132f/66cd373a2bba89540b5717cabad2554958b6b7f428be9c091bcb8a4d318b1e36/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:35.033Z",
"updated_at": "2024-09-30T07:40:35.033Z"
}
],
"tax_totals": [
]
}
Example: exceeding the monthly sales invoice limit on a free plan results in an error
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPOST \
-d '{"sales_invoice":{"reference":"30052","contact_id":433546344158725811,"details_attributes":[{"description":"Rocking Chair","price":129.95}]}}' \
https://moneybird.com/api/v2/123/sales_invoices
Response
Status: 402 Payment Required
{
"error": "creating sales invoices is limited",
"symbolic": {
"administration": "limit_reached"
}
}
Example: creating an invoice with an unknown custom field ID results in an error
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPOST \
-d '{"sales_invoice":{"reference":"30052","contact_id":433546344562427591,"details_attributes":[{"description":"Rocking Chair","price":129.95}],"custom_fields_attributes":[{"id":123456,"value":"https://example.com"}]}}' \
https://moneybird.com/api/v2/123/sales_invoices
Response
Status: 404 Not Found
{
"error": "Custom field with id 123456 not found for administration",
"symbolic": {
"custom_fields_attributes": "not_found"
}
}
Update a sales invoice
When updating a sales invoice, provide only the attributes you want to update. The other attributes will not be changed.
Parameters
| Parameter | Type | Description |
|---|---|---|
sales_invoice[contact_id] |
Integer |
Should be a valid contact id. |
sales_invoice[contact_person_id] |
Integer |
Should be a valid contact person id. |
sales_invoice[update_contact] |
Boolean |
|
sales_invoice[original_estimate_id] |
Integer |
|
sales_invoice[document_style_id] |
Integer |
Default document style is used if value is not provided. Should be a valid document style id. |
sales_invoice[workflow_id] |
Integer |
If value is not provided, the workflow saved in the contact is used. If the contact doesn’t have a default workflow, the administration’s default workflow is used. Should be a valid workflow id. |
sales_invoice[reference] |
String |
|
sales_invoice[invoice_sequence_id] |
String |
|
sales_invoice[remove_invoice_sequence_id] |
Boolean |
|
sales_invoice[invoice_date] |
String |
|
sales_invoice[first_due_interval] |
Integer |
|
sales_invoice[currency] |
String |
ISO three-character currency code, e.g. EUR or USD. |
sales_invoice[prices_are_incl_tax] |
Boolean |
|
sales_invoice[payment_conditions] |
String |
|
sales_invoice[discount] |
Decimal |
Discount percentage, e.g. 10,0%. |
sales_invoice[details_attributes][id] |
Integer |
|
sales_invoice[details_attributes][description] |
String |
|
sales_invoice[details_attributes][period] |
String |
String with a date range: |
sales_invoice[details_attributes][price] |
Decimal |
Both a decimal and a string ‘10,95’ are accepted. |
sales_invoice[details_attributes][amount] |
String |
|
sales_invoice[details_attributes][tax_rate_id] |
Integer |
Should be a valid tax rate id. |
sales_invoice[details_attributes][ledger_account_id] |
Integer |
Should be a valid ledger account id. |
sales_invoice[details_attributes][project_id] |
Integer |
Should be a valid project id. |
sales_invoice[details_attributes][product_id] |
Integer |
Should be a valid product id. |
sales_invoice[details_attributes][time_entry_ids] |
Array[integer] |
|
sales_invoice[details_attributes][trip_ids] |
Array[integer] |
|
sales_invoice[details_attributes][row_order] |
Integer |
|
sales_invoice[details_attributes][_destroy] |
Boolean |
|
sales_invoice[details_attributes][automated_tax_enabled] |
Boolean |
|
sales_invoice[custom_fields_attributes][id] |
Integer |
Required |
sales_invoice[custom_fields_attributes][value] |
String |
Required |
Example: updating the sales invoice reference
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPATCH \
-d '{"sales_invoice":{"reference":"30053"}}' \
https://moneybird.com/api/v2/123/sales_invoices/433546345300625129
Response
Status: 200 OK
{
"id": "433546345300625129",
"administration_id": 123,
"contact_id": "433546345234564838",
"contact": {
"id": "433546345234564838",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:36.112Z",
"updated_at": "2024-09-30T07:40:36.112Z",
"version": 1727682036,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/0c9a37fecfcdf8e5eef849658ffdf23358817015807114fbd44bc97459ce4fa2/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"invoice_id": null,
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": 1,
"state": "draft",
"invoice_date": null,
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": null,
"short_payment_reference": null,
"reference": "30053",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": null,
"created_at": "2024-09-30T07:40:36.175Z",
"updated_at": "2024-09-30T07:40:36.256Z",
"public_view_code": null,
"public_view_code_expires_at": null,
"version": 1727682036,
"details": [
{
"id": "433546345302722282",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "1 x",
"amount_decimal": "1.0",
"description": "Project X",
"price": "300.0",
"period": null,
"row_order": 1,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:36.177Z",
"updated_at": "2024-09-30T07:40:36.177Z"
}
],
"payments": [
],
"total_paid": "0.0",
"total_unpaid": "363.0",
"total_unpaid_base": "363.0",
"prices_are_incl_tax": false,
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": null,
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/d0cf70c686db416aa08881ef73d7f4495b3d403387c26db0c39bb30115b8ddc7/0c9a37fecfcdf8e5eef849658ffdf23358817015807114fbd44bc97459ce4fa2",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/d0cf70c686db416aa08881ef73d7f4495b3d403387c26db0c39bb30115b8ddc7/0c9a37fecfcdf8e5eef849658ffdf23358817015807114fbd44bc97459ce4fa2/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:36.181Z",
"updated_at": "2024-09-30T07:40:36.181Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "300.0",
"taxable_amount_base": "300.0",
"tax_amount": "63.0",
"tax_amount_base": "63.0"
}
]
}
Example: adding and removing a sales invoice detail
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPATCH \
-d '{"sales_invoice":{"details_attributes":[{"description":"Sofa","price":199.99},{"id":433546345529214706,"_destroy":true}]}}' \
https://moneybird.com/api/v2/123/sales_invoices/433546345526068977
Response
Status: 200 OK
{
"id": "433546345526068977",
"administration_id": 123,
"contact_id": "433546345469445870",
"contact": {
"id": "433546345469445870",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:36.336Z",
"updated_at": "2024-09-30T07:40:36.336Z",
"version": 1727682036,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/e91114119317d33d32110f0c31de9ad6d6d4e8a20a7e0e75d958eaddc1311f19/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"invoice_id": null,
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": 1,
"state": "draft",
"invoice_date": null,
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": null,
"short_payment_reference": null,
"reference": "30052",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": null,
"created_at": "2024-09-30T07:40:36.390Z",
"updated_at": "2024-09-30T07:40:36.487Z",
"public_view_code": null,
"public_view_code_expires_at": null,
"version": 1727682036,
"details": [
{
"id": "433546345625683700",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"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": "2024-09-30T07:40:36.485Z",
"updated_at": "2024-09-30T07:40:36.485Z"
}
],
"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",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": null,
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/d1bf588a9d08c2feecd364435cf240a042df1302f8a0896260d4fc33e376eb89/e91114119317d33d32110f0c31de9ad6d6d4e8a20a7e0e75d958eaddc1311f19",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/d1bf588a9d08c2feecd364435cf240a042df1302f8a0896260d4fc33e376eb89/e91114119317d33d32110f0c31de9ad6d6d4e8a20a7e0e75d958eaddc1311f19/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:36.397Z",
"updated_at": "2024-09-30T07:40:36.397Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "199.99",
"taxable_amount_base": "199.99",
"tax_amount": "42.0",
"tax_amount_base": "42.0"
}
]
}
Delete a sales invoice
Parameters
| Parameter | Type | Description |
|---|---|---|
explain_destroy |
Boolean |
Example: deletes given invoice
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XDELETE \
-d '{}' \
https://moneybird.com/api/v2/123/sales_invoices/433546347993368406.json
Response
Adds note to entity
Parameters
| Parameter | Type | Description |
|---|---|---|
note[note] |
String |
Required. Text for the note or to-do. |
note[todo] |
Boolean |
If |
note[assignee_id] |
Integer |
Assign to-do to user. Should be a valid user id. If assignee_id is provided the note will be a to-do. |
Example: create a note
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPOST \
-d '{"note":{"note":"Text of the note","assignee_id":433546359326377292,"todo":true}}' \
https://moneybird.com/api/v2/123/sales_invoices/433546359179576645/notes.json
Response
Status: 201 Created
{
"id": "433546359381951822",
"administration_id": 123,
"entity_id": "433546359179576645",
"entity_type": "SalesInvoice",
"user_id": 1727681857838,
"assignee_id": "433546359326377292",
"todo": true,
"note": "Text of the note",
"completed_at": null,
"completed_by_id": null,
"todo_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:49.604Z",
"updated_at": "2024-09-30T07:40:49.604Z"
}
Destroys note from entity
Example: destroy a note
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XDELETE \
-d '{}' \
https://moneybird.com/api/v2/123/sales_invoices/433546359499392343/notes/433546359631512926.json
Response
Create a payment
Parameters
| Parameter | Type | Description |
|---|---|---|
payment[payment_date] |
String |
Required |
payment[price] |
Decimal |
Required Both a decimal and a string ‘10,95’ are accepted. Should be a number -1,000,000,000 <= n <= 1,000,000,000. |
payment[price_base] |
Decimal |
Amount paid expressed in the base currency. Required for foreign currencies. Should be a number -1,000,000,000 <= n <= 1,000,000,000. |
payment[financial_account_id] |
Integer |
Should be a valid financial account id. |
payment[financial_mutation_id] |
Integer |
Should be a valid financial mutation id. |
payment[transaction_identifier] |
String |
|
payment[manual_payment_action] |
String |
Can be |
payment[ledger_account_id] |
Integer |
Should be a valid ledger account id. |
payment[invoice_id] |
Integer |
Example: create a payment
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPOST \
-d '{"payment":{"payment_date":"2024-09-30 07:40:39 UTC","price":"363.0"}}' \
https://moneybird.com/api/v2/123/sales_invoices/433546349115344775/payments.json
Response
Status: 201 Created
{
"id": "433546349298845582",
"administration_id": 123,
"invoice_type": "SalesInvoice",
"invoice_id": "433546349115344775",
"financial_account_id": null,
"user_id": 1727681857838,
"payment_transaction_id": null,
"transaction_identifier": null,
"price": "363.0",
"price_base": "363.0",
"payment_date": "2024-09-30",
"credit_invoice_id": null,
"financial_mutation_id": null,
"ledger_account_id": "433546158492616512",
"linked_payment_id": null,
"manual_payment_action": null,
"created_at": "2024-09-30T07:40:39.988Z",
"updated_at": "2024-09-30T07:40:39.988Z"
}
Delete a payment
Example: destroy a payment
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XDELETE \
-d '{}' \
https://moneybird.com/api/v2/123/sales_invoices/433546349601884063/payments/433546349741344677.json
Response
Download attachment
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.
Delete an attachment
Deletes an attachment of an attachable.
Sends an invoice
This endpoint provides two options: sending the invoice and scheduling sending in the future. When sending now, you can provide a send method, email address and message. If you don’t provide any arguments, the defaults from the contact and workflow will be used.
When scheduling sending, set the boolean sending_scheduled to true and provide an invoice_date.
Parameters
| Parameter | Type | Description |
|---|---|---|
sales_invoice_sending[delivery_method] |
String |
Can be |
sales_invoice_sending[sending_scheduled] |
Boolean |
|
sales_invoice_sending[deliver_ubl] |
Boolean |
|
sales_invoice_sending[mergeable] |
Boolean |
|
sales_invoice_sending[email_address] |
String |
|
sales_invoice_sending[email_message] |
String |
|
sales_invoice_sending[invoice_date] |
String |
Example: sends an invoice
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPATCH \
-d '{}' \
https://moneybird.com/api/v2/123/sales_invoices/433546345739978490/send_invoice.json
Response
Status: 200 OK
{
"id": "433546345739978490",
"administration_id": 123,
"contact_id": "433546345687549687",
"contact": {
"id": "433546345687549687",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:36.544Z",
"updated_at": "2024-09-30T07:40:36.544Z",
"version": 1727682036,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/1282e03daf813a6355f764c626e2299e7ec8d2aa9f31091958b80ddfd79b1f85/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"invoice_id": "2024-0001",
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": null,
"state": "open",
"invoice_date": "2024-09-30",
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": "RF330000000000000AVRU9K2U",
"short_payment_reference": "RF33AVRU9K2U",
"reference": "Project X",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": "2024-09-30",
"created_at": "2024-09-30T07:40:36.594Z",
"updated_at": "2024-09-30T07:40:36.740Z",
"public_view_code": "692581",
"public_view_code_expires_at": "2024-12-30T08:40:36.698Z",
"version": 1727682036,
"details": [
{
"id": "433546345742075643",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "1 x",
"amount_decimal": "1.0",
"description": "Project X",
"price": "300.0",
"period": null,
"row_order": 1,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:36.596Z",
"updated_at": "2024-09-30T07:40:36.738Z"
}
],
"payments": [
],
"total_paid": "0.0",
"total_unpaid": "363.0",
"total_unpaid_base": "363.0",
"prices_are_incl_tax": false,
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": "2024-10-14",
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/07b4ef0ece906c8ef23cb9dca1f4be3a7944bc9dfa7746410cf0d0b799205cd4/1282e03daf813a6355f764c626e2299e7ec8d2aa9f31091958b80ddfd79b1f85",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/07b4ef0ece906c8ef23cb9dca1f4be3a7944bc9dfa7746410cf0d0b799205cd4/1282e03daf813a6355f764c626e2299e7ec8d2aa9f31091958b80ddfd79b1f85/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:36.600Z",
"updated_at": "2024-09-30T07:40:36.600Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_state_changed_to_open",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:36.711Z",
"updated_at": "2024-09-30T07:40:36.711Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_send_email",
"link_entity_id": null,
"link_entity_type": null,
"data": {
"email_address": "info@example.com",
"email_message": "Geachte Foobar Holding B.V.,\n\nIn de bijlage kunt u factuur 2024-0001 voor onze diensten vinden. Wij verzoeken u vriendelijk de factuur voor 14-10-2024 te voldoen.\n\nMet vriendelijke groet,\n\nParkietje B.V."
},
"created_at": "2024-09-30T07:40:36.758Z",
"updated_at": "2024-09-30T07:40:36.758Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "300.0",
"taxable_amount_base": "300.0",
"tax_amount": "63.0",
"tax_amount_base": "63.0"
}
]
}
Example: returns error when sending invalid invoice without details
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPATCH \
-d '{}' \
https://moneybird.com/api/v2/123/sales_invoices/433546346055599878/send_invoice.json
Response
Status: 400 Bad Request
{
"error": "details cannot be empty",
"symbolic": {
"sales_invoice": "details_cannot_be_empty"
}
}
Example: returns error when sending invoice from identity without email
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPATCH \
-d '{}' \
https://moneybird.com/api/v2/123/sales_invoices/433546346285238030/send_invoice.json
Response
Status: 422 Unprocessable Entity
{
"error": {
"delivery_method": [
"Een e-mailadres in het afzenderadres is vereist"
]
}
}
Example: returns error when sending invoice to contact without email address
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPATCH \
-d '{}' \
https://moneybird.com/api/v2/123/sales_invoices/433546346470835991/send_invoice.json
Response
Status: 422 Unprocessable Entity
{
"error": {
"email_address": [
"mag niet leeg zijn"
]
}
}
Example: sends an invoice with alternative information
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPATCH \
-d '{"sales_invoice_sending":{"delivery_method":"Email","email_address":"alternative@example.com","email_message":"Hi, this is my invoice with id {invoice_id}!"}}' \
https://moneybird.com/api/v2/123/sales_invoices/433546346676356896/send_invoice.json
Response
Status: 200 OK
{
"id": "433546346676356896",
"administration_id": 123,
"contact_id": "433546346619733789",
"contact": {
"id": "433546346619733789",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:37.433Z",
"updated_at": "2024-09-30T07:40:37.433Z",
"version": 1727682037,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/5cae8c741e2a0ab9550032677dd248f033a6437b128d34d52d9606f211b064e8/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"invoice_id": "2024-0001",
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": null,
"state": "open",
"invoice_date": "2024-09-30",
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": "RF580000000000000KG6DFKWF",
"short_payment_reference": "RF58KG6DFKWF",
"reference": "Project X",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": "2024-09-30",
"created_at": "2024-09-30T07:40:37.487Z",
"updated_at": "2024-09-30T07:40:37.608Z",
"public_view_code": "423775",
"public_view_code_expires_at": "2024-12-30T08:40:37.573Z",
"version": 1727682037,
"details": [
{
"id": "433546346678454049",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "1 x",
"amount_decimal": "1.0",
"description": "Project X",
"price": "300.0",
"period": null,
"row_order": 1,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:37.489Z",
"updated_at": "2024-09-30T07:40:37.607Z"
}
],
"payments": [
],
"total_paid": "0.0",
"total_unpaid": "363.0",
"total_unpaid_base": "363.0",
"prices_are_incl_tax": false,
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": "2024-10-14",
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/8d43288d372a9ad954a068975bbebd7bf9bd3c35a3847fc2fc3bb1f4de5aa45f/5cae8c741e2a0ab9550032677dd248f033a6437b128d34d52d9606f211b064e8",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/8d43288d372a9ad954a068975bbebd7bf9bd3c35a3847fc2fc3bb1f4de5aa45f/5cae8c741e2a0ab9550032677dd248f033a6437b128d34d52d9606f211b064e8/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:37.492Z",
"updated_at": "2024-09-30T07:40:37.492Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_state_changed_to_open",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:37.583Z",
"updated_at": "2024-09-30T07:40:37.583Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_send_email",
"link_entity_id": null,
"link_entity_type": null,
"data": {
"email_address": "alternative@example.com",
"email_message": "Hi, this is my invoice with id {invoice_id}!"
},
"created_at": "2024-09-30T07:40:37.624Z",
"updated_at": "2024-09-30T07:40:37.624Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "300.0",
"taxable_amount_base": "300.0",
"tax_amount": "63.0",
"tax_amount_base": "63.0"
}
]
}
Example: sends an invoice via mail with an UBL attachment
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPATCH \
-d '{"sales_invoice_sending":{"delivery_method":"Email","deliver_ubl":true,"email_address":"alternative@example.com"}}' \
https://moneybird.com/api/v2/123/sales_invoices/433546346973103916/send_invoice.json
Response
Status: 200 OK
{
"id": "433546346973103916",
"administration_id": 123,
"contact_id": "433546346918577961",
"contact": {
"id": "433546346918577961",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:37.718Z",
"updated_at": "2024-09-30T07:40:37.718Z",
"version": 1727682037,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/cdb6a141c8210f36771dbc2cf65e67c9e6b39515fd1cdaa6fa460a40ecbd5d2e/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"invoice_id": "2024-0001",
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": null,
"state": "open",
"invoice_date": "2024-09-30",
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": "RF890000000000000KP35PSU6",
"short_payment_reference": "RF89KP35PSU6",
"reference": "Project X",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": "2024-09-30",
"created_at": "2024-09-30T07:40:37.770Z",
"updated_at": "2024-09-30T07:40:37.898Z",
"public_view_code": "334615",
"public_view_code_expires_at": "2024-12-30T08:40:37.860Z",
"version": 1727682037,
"details": [
{
"id": "433546346976249645",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "1 x",
"amount_decimal": "1.0",
"description": "Project X",
"price": "300.0",
"period": null,
"row_order": 1,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:37.773Z",
"updated_at": "2024-09-30T07:40:37.896Z"
}
],
"payments": [
],
"total_paid": "0.0",
"total_unpaid": "363.0",
"total_unpaid_base": "363.0",
"prices_are_incl_tax": false,
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": "2024-10-14",
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/17659d9d2f8eaf792fc03a485336c7ef8c57542388938bde22b3eb74a21e95b6/cdb6a141c8210f36771dbc2cf65e67c9e6b39515fd1cdaa6fa460a40ecbd5d2e",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/17659d9d2f8eaf792fc03a485336c7ef8c57542388938bde22b3eb74a21e95b6/cdb6a141c8210f36771dbc2cf65e67c9e6b39515fd1cdaa6fa460a40ecbd5d2e/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:37.776Z",
"updated_at": "2024-09-30T07:40:37.776Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_state_changed_to_open",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:37.871Z",
"updated_at": "2024-09-30T07:40:37.871Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_send_email",
"link_entity_id": null,
"link_entity_type": null,
"data": {
"email_address": "alternative@example.com",
"email_message": "Geachte Foobar Holding B.V.,\n\nIn de bijlage kunt u factuur 2024-0001 voor onze diensten vinden. Wij verzoeken u vriendelijk de factuur voor 14-10-2024 te voldoen.\n\nMet vriendelijke groet,\n\nParkietje B.V."
},
"created_at": "2024-09-30T07:40:37.914Z",
"updated_at": "2024-09-30T07:40:37.914Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "300.0",
"taxable_amount_base": "300.0",
"tax_amount": "63.0",
"tax_amount_base": "63.0"
}
]
}
Example: schedule sending
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPATCH \
-d '{"sales_invoice_sending":{"sending_scheduled":true,"invoice_date":"2024-10-01"}}' \
https://moneybird.com/api/v2/123/sales_invoices/433546347245733688/send_invoice.json
Response
Status: 200 OK
{
"id": "433546347245733688",
"administration_id": 123,
"contact_id": "433546347194353461",
"contact": {
"id": "433546347194353461",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:37.981Z",
"updated_at": "2024-09-30T07:40:37.981Z",
"version": 1727682037,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/18988d519b663126371e046d39a5939ea1da186552c7d92aacf297520f9299a6/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"invoice_id": null,
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": 1,
"state": "scheduled",
"invoice_date": "2024-10-01",
"due_date": "2024-10-15",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": null,
"short_payment_reference": null,
"reference": "Project X",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": null,
"created_at": "2024-09-30T07:40:38.030Z",
"updated_at": "2024-09-30T07:40:38.147Z",
"public_view_code": null,
"public_view_code_expires_at": null,
"version": 1727682038,
"details": [
{
"id": "433546347247830841",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "1 x",
"amount_decimal": "1.0",
"description": "Project X",
"price": "300.0",
"period": null,
"row_order": 1,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:38.032Z",
"updated_at": "2024-09-30T07:40:38.145Z"
}
],
"payments": [
],
"total_paid": "0.0",
"total_unpaid": "363.0",
"total_unpaid_base": "363.0",
"prices_are_incl_tax": false,
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": null,
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/66dec9a72361f443ff7835ef9b9a9e420722236ce69c883926a3fd4620fbb139/18988d519b663126371e046d39a5939ea1da186552c7d92aacf297520f9299a6",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/66dec9a72361f443ff7835ef9b9a9e420722236ce69c883926a3fd4620fbb139/18988d519b663126371e046d39a5939ea1da186552c7d92aacf297520f9299a6/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:38.050Z",
"updated_at": "2024-09-30T07:40:38.050Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_state_changed_to_scheduled",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:38.135Z",
"updated_at": "2024-09-30T07:40:38.135Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "300.0",
"taxable_amount_base": "300.0",
"tax_amount": "63.0",
"tax_amount_base": "63.0"
}
]
}
DEPRECATED: Register a payment
This endpoint is deprecated and should no longer be used. It has been replaced by Create a payment.
Parameters
| Parameter | Type | Description |
|---|---|---|
payment[payment_date] |
String |
Required |
payment[price] |
Decimal |
Required Both a decimal and a string ‘10,95’ are accepted. Should be a number -1,000,000,000 <= n <= 1,000,000,000. |
payment[price_base] |
Decimal |
Amount paid expressed in the base currency. Required for foreign currencies. Should be a number -1,000,000,000 <= n <= 1,000,000,000. |
payment[financial_account_id] |
Integer |
Should be a valid financial account id. |
payment[financial_mutation_id] |
Integer |
Should be a valid financial mutation id. |
payment[transaction_identifier] |
String |
|
payment[manual_payment_action] |
String |
Can be |
payment[ledger_account_id] |
Integer |
Should be a valid ledger account id. |
payment[invoice_id] |
Integer |
Example: registers payments
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPATCH \
-d '{"payment":{"payment_date":"2024-09-30 07:40:39 UTC","price":"363.0"}}' \
https://moneybird.com/api/v2/123/sales_invoices/433546348214617951/register_payment.json
Response
Status: 200 OK
{
"id": "433546348412798822",
"administration_id": 123,
"invoice_type": "SalesInvoice",
"invoice_id": "433546348214617951",
"financial_account_id": null,
"user_id": 1727681857838,
"payment_transaction_id": null,
"transaction_identifier": null,
"price": "363.0",
"price_base": "363.0",
"payment_date": "2024-09-30",
"credit_invoice_id": null,
"financial_mutation_id": null,
"ledger_account_id": "433546158492616512",
"linked_payment_id": null,
"manual_payment_action": null,
"created_at": "2024-09-30T07:40:39.144Z",
"updated_at": "2024-09-30T07:40:39.144Z"
}
Register a payment for a creditinvoice
Example: registers payments for a credit invoice
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPATCH \
-d '{}' \
https://moneybird.com/api/v2/123/sales_invoices/433546348696962933/register_payment_creditinvoice.json
Response
Status: 200 OK
{
"id": "433546348696962933",
"administration_id": 123,
"contact_id": "433546348475713387",
"contact": {
"id": "433546348475713387",
"administration_id": 123,
"company_name": "Foobar Holding B.V.",
"firstname": "",
"lastname": "",
"address1": "Hoofdstraat 12",
"address2": "",
"zipcode": "1234AB",
"city": "Amsterdam",
"country": "NL",
"phone": "",
"delivery_method": "Email",
"customer_id": "1",
"tax_number": "",
"chamber_of_commerce": "",
"bank_account": "",
"is_trusted": false,
"max_transfer_amount": null,
"attention": "",
"email": "info@example.com",
"email_ubl": true,
"send_invoices_to_attention": "",
"send_invoices_to_email": "info@example.com",
"send_estimates_to_attention": "",
"send_estimates_to_email": "info@example.com",
"sepa_active": false,
"sepa_iban": "",
"sepa_iban_account_name": "",
"sepa_bic": "",
"sepa_mandate_id": "",
"sepa_mandate_date": null,
"sepa_sequence_type": "RCUR",
"credit_card_number": "",
"credit_card_reference": "",
"credit_card_type": null,
"tax_number_validated_at": null,
"tax_number_valid": null,
"invoice_workflow_id": null,
"estimate_workflow_id": null,
"si_identifier": "",
"si_identifier_type": null,
"moneybird_payments_mandate": false,
"created_at": "2024-09-30T07:40:39.203Z",
"updated_at": "2024-09-30T07:40:39.203Z",
"version": 1727682039,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/59b909dfa763e018dec3abc834e776bd6bd9b507d5d37c8de26011e12acbe10b/all",
"notes": [
],
"custom_fields": [
],
"contact_people": [
],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"invoice_id": "2024-0002",
"recurring_sales_invoice_id": null,
"subscription_id": null,
"workflow_id": "433546158700234574",
"document_style_id": "433546158841792344",
"identity_id": "433546158546093901",
"draft_id": null,
"state": "paid",
"invoice_date": "2024-09-30",
"due_date": "2024-10-14",
"payment_conditions": "We verzoeken u vriendelijk het bovenstaande bedrag van {document.total_price} voor {document.due_date} te voldoen op onze bankrekening onder vermelding van de omschrijving {document.payment_reference}. Voor vragen kunt u contact opnemen per e-mail.",
"payment_reference": "RF6800000000000004YQCUNEX",
"short_payment_reference": "RF684YQCUNEX",
"reference": "Project X",
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": "433546348528142190",
"paused": false,
"paid_at": "2024-09-30",
"sent_at": "2024-09-30",
"created_at": "2024-09-30T07:40:39.413Z",
"updated_at": "2024-09-30T07:40:39.641Z",
"public_view_code": "534889",
"public_view_code_expires_at": "2024-12-30T07:40:39.474Z",
"version": 1727682039,
"details": [
{
"id": "433546348699060086",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": null,
"amount_decimal": "1.0",
"description": "**Creditfactuur voor factuur 2024-0001**",
"price": "0.0",
"period": null,
"row_order": 1,
"total_price_excl_tax_with_discount": "0.0",
"total_price_excl_tax_with_discount_base": "0.0",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": "",
"created_at": "2024-09-30T07:40:39.416Z",
"updated_at": "2024-09-30T07:40:39.526Z"
},
{
"id": "433546348701157239",
"administration_id": 123,
"tax_rate_id": "433546158515685191",
"ledger_account_id": "433546158461159223",
"project_id": null,
"product_id": null,
"amount": "-1 x",
"amount_decimal": "-1.0",
"description": "Project X",
"price": "300.0",
"period": null,
"row_order": 2,
"total_price_excl_tax_with_discount": "-300.0",
"total_price_excl_tax_with_discount_base": "-300.0",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2024-09-30T07:40:39.418Z",
"updated_at": "2024-09-30T07:40:39.528Z"
}
],
"payments": [
{
"id": "433546348917163900",
"administration_id": 123,
"invoice_type": "SalesInvoice",
"invoice_id": "433546348696962933",
"financial_account_id": null,
"user_id": 1727681857838,
"payment_transaction_id": null,
"transaction_identifier": null,
"price": "-363.0",
"price_base": "-363.0",
"payment_date": "2024-09-30",
"credit_invoice_id": null,
"financial_mutation_id": null,
"ledger_account_id": "433546158492616515",
"linked_payment_id": null,
"manual_payment_action": null,
"created_at": "2024-09-30T07:40:39.624Z",
"updated_at": "2024-09-30T07:40:39.624Z"
}
],
"total_paid": "-363.0",
"total_unpaid": "0.0",
"total_unpaid_base": "0.0",
"prices_are_incl_tax": false,
"total_price_excl_tax": "-300.0",
"total_price_excl_tax_base": "-300.0",
"total_price_incl_tax": "-363.0",
"total_price_incl_tax_base": "-363.0",
"total_discount": "0.0",
"marked_dubious_on": null,
"marked_uncollectible_on": null,
"reminder_count": 0,
"next_reminder": "2024-10-14",
"original_estimate_id": null,
"url": "http://moneybird.dev/123/sales_invoices/890df03ed935bbfa0560c96ab979ba5735216ff35966aef25b660c9159605ad6/59b909dfa763e018dec3abc834e776bd6bd9b507d5d37c8de26011e12acbe10b",
"payment_url": "http://moneybird.dev/123/online_sales_invoices/890df03ed935bbfa0560c96ab979ba5735216ff35966aef25b660c9159605ad6/59b909dfa763e018dec3abc834e776bd6bd9b507d5d37c8de26011e12acbe10b/pay_invoice",
"custom_fields": [
],
"notes": [
],
"attachments": [
],
"events": [
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "credit_invoice_created_from_original",
"link_entity_id": null,
"link_entity_type": null,
"data": {
"original_invoice": "2024-0001"
},
"created_at": "2024-09-30T07:40:39.421Z",
"updated_at": "2024-09-30T07:40:39.421Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_state_changed_to_open",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:39.490Z",
"updated_at": "2024-09-30T07:40:39.490Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_send_email",
"link_entity_id": null,
"link_entity_type": null,
"data": {
"email_address": "info@example.com",
"email_message": "Geachte Foobar Holding B.V.,\n\nIn de bijlage kunt u factuur 2024-0002 voor onze diensten vinden. Wij verzoeken u vriendelijk de factuur voor 14-10-2024 te voldoen.\n\nMet vriendelijke groet,\n\nParkietje B.V."
},
"created_at": "2024-09-30T07:40:39.546Z",
"updated_at": "2024-09-30T07:40:39.546Z"
},
{
"administration_id": 123,
"user_id": 1727681857838,
"action": "sales_invoice_state_changed_to_paid",
"link_entity_id": null,
"link_entity_type": null,
"data": {
},
"created_at": "2024-09-30T07:40:39.627Z",
"updated_at": "2024-09-30T07:40:39.627Z"
}
],
"tax_totals": [
{
"tax_rate_id": "433546158515685191",
"taxable_amount": "-300.0",
"taxable_amount_base": "-300.0",
"tax_amount": "-63.0",
"tax_amount_base": "-63.0"
}
]
}
Sends a reminder
This endpoint sends a reminder to a contact. A reminder can contain multiple sales invoices. Reminders are grouped by workflow, identity and document style, so a contact with sales invoices with different workflows, will receive multiple reminders. Only by grouping reminders like this, we can assure the right content and layout of a reminder.
Parameters
| Parameter | Type | Description |
|---|---|---|
sales_invoice_reminders |
Array |
Required |
sales_invoice_reminders[contact_id] |
Integer |
Required |
sales_invoice_reminders[workflow_id] |
Integer |
Required |
sales_invoice_reminders[identity_id] |
Integer |
Required |
sales_invoice_reminders[document_style_id] |
Integer |
Required |
sales_invoice_reminders[sales_invoice_ids] |
Array |
Required |
sales_invoice_reminders[reminder_text] |
String |
|
sales_invoice_reminders[delivery_method] |
String |
|
sales_invoice_reminders[email_address] |
String |
Example: sends reminders for given invoices
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPOST \
-d '{"sales_invoice_reminders":[{"contact_id":433546350124074937,"workflow_id":433546350163920827,"document_style_id":433546158841792344,"identity_id":433546158546093901,"sales_invoice_ids":[433546350234175425]},{"contact_id":433546350124074937,"workflow_id":433546350389364679,"document_style_id":433546158841792344,"identity_id":433546158546093901,"sales_invoice_ids":[433546350471153613]},{"contact_id":433546350612711380,"workflow_id":433546350163920827,"document_style_id":433546158841792344,"identity_id":433546158546093901,"sales_invoice_ids":[433546350659897302,433546350824523740]}]}' \
https://moneybird.com/api/v2/123/sales_invoices/send_reminders.json
Response
Status: 200 OK
200
Example: returns an error when invalid parameters are given
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPOST \
-d '{"sales_invoice_reminders":[{"contact_id":433546351447377913,"workflow_id":433546351486175227,"document_style_id":433546158841792344,"identity_id":433546158546093901,"sales_invoice_ids":[433546351553283073],"email_address":"invalid.email"}]}' \
https://moneybird.com/api/v2/123/sales_invoices/send_reminders.json
Response
Status: 422 Unprocessable Entity
{
"errors": [
{
"email_address": [
"is geen correct e-mailadres"
]
}
]
}
Example: returns an error if delivery_method Simplerinvoicing is given
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPOST \
-d '{"sales_invoice_reminders":[{"contact_id":433546352575644721,"workflow_id":433546352613393459,"document_style_id":433546158841792344,"identity_id":433546158546093901,"sales_invoice_ids":[433546352683648057],"delivery_method":"Simplerinvoicing"}]}' \
https://moneybird.com/api/v2/123/sales_invoices/send_reminders.json
Response
Status: 400 Bad Request
{
"error": "Delivery Method isn't an option",
"symbolic": {
"sales_invoice_reminders": {
"reminders_for_contacts_attributes": {
"0": {
"delivery_method": "in"
}
}
}
}
}
Example: sends via Email if contact has delivery_method Simplerinvoicing
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPOST \
-d '{"sales_invoice_reminders":[{"contact_id":433546353704961129,"workflow_id":433546353742709867,"document_style_id":433546158841792344,"identity_id":433546158546093901,"sales_invoice_ids":[433546353812964465]}]}' \
https://moneybird.com/api/v2/123/sales_invoices/send_reminders.json
Response
Status: 200 OK
200
Pause sales invoice
This endpoint pauses a sales invoice. The automatic workflow steps will not be executed while the sales invoice is paused.
Resume sales invoice
This endpoint resumes the sales invoice. The automatic workflow steps will execute again after resuming.
Duplicate to credit invoice
Mark as dubious
This endpoint marks a sales invoice as dubious.
Parameters
| Parameter | Type | Description |
|---|---|---|
dubious_date |
Date |
Mark as uncollectible
This endpoint marks a sales invoice as uncollectible.
Parameters
| Parameter | Type | Description |
|---|---|---|
uncollectible_date |
Date |
|
book_method |
String |
Can be |
Add attachment to sales invoice
Example: uploads an attachment
Request
curl -s -H "Content-Type: multipart/mixed" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPOST \
-F file=@/tmp/upload.pdf \
https://moneybird.com/api/v2/123/sales_invoices/433546359873733992/attachments.json
Response
Status: 200 OK
200