Documents: Purchase invoices
List ids and versions of purchase invoices
Returns all documents in the administration. The list contains the document id and the version of the document.
Check if the version of the document is newer than the version you have stored locally, use the POST
variant for fetching documents with the given ids.
Parameters
| Parameter | Type | Description |
|---|---|---|
filter |
String |
String terms, example: key1:value1,key2:value2. |
Example: retrieves all ids for synchronization
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/documents/purchase_invoices/synchronization.json?
Response
Status: 200 OK
[
{
"id": "446241585438394352",
"version": 1739789160
},
{
"id": "446241585546397692",
"version": 1739789160
},
{
"id": "446241585598825474",
"version": 1739789160
}
]
Example: retrieves all ids for synchronization using a filter
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/documents/purchase_invoices/synchronization.json?filter=period%3Athis_month
Response
Status: 200 OK
[
{
"id": "446241585765549069",
"version": 1739789160
},
{
"id": "446241585849435161",
"version": 1739789161
},
{
"id": "446241585890329631",
"version": 1739789161
}
]
Fetch purchase invoices with given ids
Given a list of document ids, returns the document information belonging to the documents. Returns a maximum of 100 documents, even if more ids are provided.
Parameters
| Parameter | Type | Description |
|---|---|---|
ids |
Array[integer] |
Required |
Example: retrieves documents for given ids
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPOST \
-d '{"ids":[446241586158765110,446241586209096764]}' \
https://moneybird.com/api/v2/123/documents/purchase_invoices/synchronization.json
Response
Status: 200 OK
[
{
"id": "446241586158765110",
"administration_id": 123,
"contact_id": "446241586053907495",
"contact": {
"id": "446241586053907495",
"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": "2025-02-17T10:46:01.252Z",
"updated_at": "2025-02-17T10:46:01.252Z",
"version": 1739789161,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/4f11b86832f70e82206e2f3e03d611f3d02a402fa8495b314c91f4c53a8c1ea8/all",
"notes": [],
"custom_fields": [],
"contact_people": [],
"archived": false
},
"reference": "2013-01234",
"date": "2025-02-17",
"due_date": "2025-03-03",
"entry_number": 3,
"state": "open",
"currency": "EUR",
"exchange_rate": "1.0",
"revenue_invoice": false,
"prices_are_incl_tax": false,
"origin": null,
"paid_at": null,
"tax_number": "",
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"created_at": "2025-02-17T10:46:01.352Z",
"updated_at": "2025-02-17T10:46:01.355Z",
"version": 1739789161,
"details": [
{
"id": "446241586159813687",
"administration_id": 123,
"tax_rate_id": "446241518964966551",
"ledger_account_id": "446241518911489155",
"project_id": null,
"product_id": null,
"amount": null,
"amount_decimal": "1.0",
"description": "Delivery Apple iPad",
"price": "300.0",
"period": null,
"row_order": 0,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/5b"
],
"mandatory_tax_text": null,
"created_at": "2025-02-17T10:46:01.354Z",
"updated_at": "2025-02-17T10:46:01.354Z",
"time_entries": []
}
],
"payments": [],
"notes": [],
"attachments": [],
"events": [
{
"administration_id": 123,
"user_id": 17397890963220,
"action": "document_saved",
"link_entity_id": null,
"link_entity_type": null,
"data": {},
"created_at": "2025-02-17T10:46:01.357Z",
"updated_at": "2025-02-17T10:46:01.357Z"
}
]
},
{
"id": "446241586209096764",
"administration_id": 123,
"contact_id": "446241586053907495",
"contact": {
"id": "446241586053907495",
"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": "2025-02-17T10:46:01.252Z",
"updated_at": "2025-02-17T10:46:01.252Z",
"version": 1739789161,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/4f11b86832f70e82206e2f3e03d611f3d02a402fa8495b314c91f4c53a8c1ea8/all",
"notes": [],
"custom_fields": [],
"contact_people": [],
"archived": false
},
"reference": "2013-01234",
"date": "2025-02-17",
"due_date": "2025-03-03",
"entry_number": 4,
"state": "open",
"currency": "EUR",
"exchange_rate": "1.0",
"revenue_invoice": false,
"prices_are_incl_tax": false,
"origin": null,
"paid_at": null,
"tax_number": "",
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"created_at": "2025-02-17T10:46:01.400Z",
"updated_at": "2025-02-17T10:46:01.404Z",
"version": 1739789161,
"details": [
{
"id": "446241586211193917",
"administration_id": 123,
"tax_rate_id": "446241518964966551",
"ledger_account_id": "446241518911489155",
"project_id": null,
"product_id": null,
"amount": null,
"amount_decimal": "1.0",
"description": "Delivery Apple iPad",
"price": "300.0",
"period": null,
"row_order": 0,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/5b"
],
"mandatory_tax_text": null,
"created_at": "2025-02-17T10:46:01.402Z",
"updated_at": "2025-02-17T10:46:01.402Z",
"time_entries": []
}
],
"payments": [],
"notes": [],
"attachments": [],
"events": [
{
"administration_id": 123,
"user_id": 17397890963220,
"action": "document_saved",
"link_entity_id": null,
"link_entity_type": null,
"data": {},
"created_at": "2025-02-17T10:46:01.406Z",
"updated_at": "2025-02-17T10:46:01.406Z"
}
]
}
]
Get purchase invoices
Returns a paginated list of documents of this type in the administration.
The filter argument allows you to filter on the list of documents. Filters are a combination of keys and values,
separated by a comma: key:value,key2:value2. The most common filter method will be period: period:this_month.
Filtering works the same as in the web application, for more advanced examples, change the filtering in the web
application and learn from the resulting URI.
Parameters
| Parameter | Type | Description |
|---|---|---|
filter |
String |
Required String terms, example: |
new_filter |
String |
String terms, example: |
page |
Integer |
|
per_page |
Integer |
|
exclude_new_general_journal_documents |
Boolean |
Example: returns a list of purchase_invoices
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/documents/purchase_invoices.json?
Response
Status: 200 OK
[
{
"id": "446241579891426931",
"administration_id": 123,
"contact_id": "446241579714217560",
"contact": {
"id": "446241579714217560",
"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": "2025-02-17T10:45:55.207Z",
"updated_at": "2025-02-17T10:45:55.207Z",
"version": 1739789155,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/3371175e9d31b6c7756af544f14c907b921ff9e62e87a397c494c1db44f87c59/all",
"notes": [],
"custom_fields": [],
"contact_people": [],
"archived": false
},
"reference": "2013-01234",
"date": "2025-02-17",
"due_date": "2025-03-03",
"entry_number": 5,
"state": "open",
"currency": "EUR",
"exchange_rate": "1.0",
"revenue_invoice": false,
"prices_are_incl_tax": false,
"origin": null,
"paid_at": null,
"tax_number": "",
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"created_at": "2025-02-17T10:45:55.376Z",
"updated_at": "2025-02-17T10:45:55.379Z",
"version": 1739789155,
"details": [
{
"id": "446241579893524084",
"administration_id": 123,
"tax_rate_id": "446241518964966551",
"ledger_account_id": "446241518911489155",
"project_id": null,
"product_id": null,
"amount": null,
"amount_decimal": "1.0",
"description": "Delivery Apple iPad",
"price": "300.0",
"period": null,
"row_order": 0,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/5b"
],
"mandatory_tax_text": null,
"created_at": "2025-02-17T10:45:55.377Z",
"updated_at": "2025-02-17T10:45:55.377Z",
"time_entries": []
}
],
"payments": [],
"notes": [],
"attachments": [],
"events": [
{
"administration_id": 123,
"user_id": 17397890963220,
"action": "document_saved",
"link_entity_id": null,
"link_entity_type": null,
"data": {},
"created_at": "2025-02-17T10:45:55.380Z",
"updated_at": "2025-02-17T10:45:55.380Z"
}
]
},
{
"id": "446241579855775341",
"administration_id": 123,
"contact_id": "446241579714217560",
"contact": {
"id": "446241579714217560",
"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": "2025-02-17T10:45:55.207Z",
"updated_at": "2025-02-17T10:45:55.207Z",
"version": 1739789155,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/3371175e9d31b6c7756af544f14c907b921ff9e62e87a397c494c1db44f87c59/all",
"notes": [],
"custom_fields": [],
"contact_people": [],
"archived": false
},
"reference": "2013-01234",
"date": "2025-02-17",
"due_date": "2025-03-03",
"entry_number": 4,
"state": "open",
"currency": "EUR",
"exchange_rate": "1.0",
"revenue_invoice": false,
"prices_are_incl_tax": false,
"origin": null,
"paid_at": null,
"tax_number": "",
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"created_at": "2025-02-17T10:45:55.342Z",
"updated_at": "2025-02-17T10:45:55.345Z",
"version": 1739789155,
"details": [
{
"id": "446241579857872494",
"administration_id": 123,
"tax_rate_id": "446241518964966551",
"ledger_account_id": "446241518911489155",
"project_id": null,
"product_id": null,
"amount": null,
"amount_decimal": "1.0",
"description": "Delivery Apple iPad",
"price": "300.0",
"period": null,
"row_order": 0,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/5b"
],
"mandatory_tax_text": null,
"created_at": "2025-02-17T10:45:55.344Z",
"updated_at": "2025-02-17T10:45:55.344Z",
"time_entries": []
}
],
"payments": [],
"notes": [],
"attachments": [],
"events": [
{
"administration_id": 123,
"user_id": 17397890963220,
"action": "document_saved",
"link_entity_id": null,
"link_entity_type": null,
"data": {},
"created_at": "2025-02-17T10:45:55.346Z",
"updated_at": "2025-02-17T10:45:55.346Z"
}
]
},
{
"id": "446241579820123751",
"administration_id": 123,
"contact_id": "446241579714217560",
"contact": {
"id": "446241579714217560",
"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": "2025-02-17T10:45:55.207Z",
"updated_at": "2025-02-17T10:45:55.207Z",
"version": 1739789155,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/3371175e9d31b6c7756af544f14c907b921ff9e62e87a397c494c1db44f87c59/all",
"notes": [],
"custom_fields": [],
"contact_people": [],
"archived": false
},
"reference": "2013-01234",
"date": "2025-02-17",
"due_date": "2025-03-03",
"entry_number": 3,
"state": "open",
"currency": "EUR",
"exchange_rate": "1.0",
"revenue_invoice": false,
"prices_are_incl_tax": false,
"origin": null,
"paid_at": null,
"tax_number": "",
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"created_at": "2025-02-17T10:45:55.308Z",
"updated_at": "2025-02-17T10:45:55.311Z",
"version": 1739789155,
"details": [
{
"id": "446241579822220904",
"administration_id": 123,
"tax_rate_id": "446241518964966551",
"ledger_account_id": "446241518911489155",
"project_id": null,
"product_id": null,
"amount": null,
"amount_decimal": "1.0",
"description": "Delivery Apple iPad",
"price": "300.0",
"period": null,
"row_order": 0,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/5b"
],
"mandatory_tax_text": null,
"created_at": "2025-02-17T10:45:55.309Z",
"updated_at": "2025-02-17T10:45:55.309Z",
"time_entries": []
}
],
"payments": [],
"notes": [],
"attachments": [],
"events": [
{
"administration_id": 123,
"user_id": 17397890963220,
"action": "document_saved",
"link_entity_id": null,
"link_entity_type": null,
"data": {},
"created_at": "2025-02-17T10:45:55.312Z",
"updated_at": "2025-02-17T10:45:55.312Z"
}
]
}
]
Example: returns paginated purchase invoices on page 1
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/documents/purchase_invoices.json?per_page=1
Response
Status: 200 OK
[
{
"id": "446241580205999766",
"administration_id": 123,
"contact_id": "446241580028790395",
"contact": {
"id": "446241580028790395",
"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": "2025-02-17T10:45:55.506Z",
"updated_at": "2025-02-17T10:45:55.506Z",
"version": 1739789155,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/a57a8b3b8e39b5ee55db2efc2e9124fe98863e490c468ea97713fcb0c8ed7f2e/all",
"notes": [],
"custom_fields": [],
"contact_people": [],
"archived": false
},
"reference": "2013-01234",
"date": "2025-02-17",
"due_date": "2025-03-03",
"entry_number": 5,
"state": "open",
"currency": "EUR",
"exchange_rate": "1.0",
"revenue_invoice": false,
"prices_are_incl_tax": false,
"origin": null,
"paid_at": null,
"tax_number": "",
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"created_at": "2025-02-17T10:45:55.675Z",
"updated_at": "2025-02-17T10:45:55.678Z",
"version": 1739789155,
"details": [
{
"id": "446241580207048343",
"administration_id": 123,
"tax_rate_id": "446241518964966551",
"ledger_account_id": "446241518911489155",
"project_id": null,
"product_id": null,
"amount": null,
"amount_decimal": "1.0",
"description": "Delivery Apple iPad",
"price": "300.0",
"period": null,
"row_order": 0,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/5b"
],
"mandatory_tax_text": null,
"created_at": "2025-02-17T10:45:55.677Z",
"updated_at": "2025-02-17T10:45:55.677Z",
"time_entries": []
}
],
"payments": [],
"notes": [],
"attachments": [],
"events": [
{
"administration_id": 123,
"user_id": 17397890963220,
"action": "document_saved",
"link_entity_id": null,
"link_entity_type": null,
"data": {},
"created_at": "2025-02-17T10:45:55.679Z",
"updated_at": "2025-02-17T10:45:55.679Z"
}
]
}
]
Example: returns paginated purchase invoices on page 2
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/documents/purchase_invoices.json?page=2&per_page=1
Response
Status: 200 OK
[
{
"id": "446241580479678131",
"administration_id": 123,
"contact_id": "446241580346508958",
"contact": {
"id": "446241580346508958",
"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": "2025-02-17T10:45:55.809Z",
"updated_at": "2025-02-17T10:45:55.809Z",
"version": 1739789155,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/20197125e58d2d0420ee3dd813ff533f531780dec2caeea03d123de0d3868ec0/all",
"notes": [],
"custom_fields": [],
"contact_people": [],
"archived": false
},
"reference": "2013-01234",
"date": "2025-02-17",
"due_date": "2025-03-03",
"entry_number": 4,
"state": "open",
"currency": "EUR",
"exchange_rate": "1.0",
"revenue_invoice": false,
"prices_are_incl_tax": false,
"origin": null,
"paid_at": null,
"tax_number": "",
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"created_at": "2025-02-17T10:45:55.937Z",
"updated_at": "2025-02-17T10:45:55.940Z",
"version": 1739789155,
"details": [
{
"id": "446241580481775284",
"administration_id": 123,
"tax_rate_id": "446241518964966551",
"ledger_account_id": "446241518911489155",
"project_id": null,
"product_id": null,
"amount": null,
"amount_decimal": "1.0",
"description": "Delivery Apple iPad",
"price": "300.0",
"period": null,
"row_order": 0,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/5b"
],
"mandatory_tax_text": null,
"created_at": "2025-02-17T10:45:55.939Z",
"updated_at": "2025-02-17T10:45:55.939Z",
"time_entries": []
}
],
"payments": [],
"notes": [],
"attachments": [],
"events": [
{
"administration_id": 123,
"user_id": 17397890963220,
"action": "document_saved",
"link_entity_id": null,
"link_entity_type": null,
"data": {},
"created_at": "2025-02-17T10:45:55.941Z",
"updated_at": "2025-02-17T10:45:55.941Z"
}
]
}
]
Example: returns an error when too many purchase invoices are requested
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/documents/purchase_invoices.json?per_page=101
Response
Status: 400 Bad Request
{
"error": "Per Page is too big",
"symbolic": {
"per_page": "max"
}
}
Get purchase invoices
Example: returns the wanted purchase_invoice
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/documents/purchase_invoices/446241581444368144.json?
Response
Status: 200 OK
{
"id": "446241581444368144",
"administration_id": 123,
"contact_id": "446241581404522253",
"contact": {
"id": "446241581404522253",
"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": "2025-02-17T10:45:56.818Z",
"updated_at": "2025-02-17T10:45:56.818Z",
"version": 1739789156,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/f683ec203693953034b06a2af082267ce527f58d301d7487fc85bee33fbd0763/all",
"notes": [],
"custom_fields": [],
"contact_people": [],
"archived": false
},
"reference": "2013-01234",
"date": "2025-02-17",
"due_date": "2025-03-03",
"entry_number": 1,
"state": "open",
"currency": "EUR",
"exchange_rate": "1.0",
"revenue_invoice": false,
"prices_are_incl_tax": false,
"origin": null,
"paid_at": null,
"tax_number": "",
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"created_at": "2025-02-17T10:45:56.856Z",
"updated_at": "2025-02-17T10:45:56.861Z",
"version": 1739789156,
"details": [
{
"id": "446241581446465297",
"administration_id": 123,
"tax_rate_id": "446241518964966551",
"ledger_account_id": "446241518911489155",
"project_id": null,
"product_id": null,
"amount": null,
"amount_decimal": "1.0",
"description": "Delivery Apple iPad",
"price": "300.0",
"period": null,
"row_order": 0,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/5b"
],
"mandatory_tax_text": null,
"created_at": "2025-02-17T10:45:56.858Z",
"updated_at": "2025-02-17T10:45:56.858Z",
"time_entries": []
}
],
"payments": [],
"notes": [],
"attachments": [],
"events": [
{
"administration_id": 123,
"user_id": 17397890963220,
"action": "document_saved",
"link_entity_id": null,
"link_entity_type": null,
"data": {},
"created_at": "2025-02-17T10:45:56.863Z",
"updated_at": "2025-02-17T10:45:56.863Z"
}
]
}
Example: only returns purchase_invoices
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/documents/purchase_invoices/446241581699172135.json?
Response
Status: 404 Not Found
{
"error": "record not found",
"symbolic": {
"id": "not_found"
}
}
Create a new purchase invoices
Parameters
| Parameter | Type | Description |
|---|---|---|
purchase_invoice[contact_id] |
Integer |
Required. Should be a valid contact id. |
purchase_invoice[reference] |
String |
Required. |
purchase_invoice[date] |
String |
Required Required. |
purchase_invoice[due_date] |
String |
|
purchase_invoice[currency] |
String |
ISO three-character currency code, e.g. EUR or USD. |
purchase_invoice[prices_are_incl_tax] |
Boolean |
|
purchase_invoice[revenue_invoice] |
Boolean |
|
purchase_invoice[details_attributes][id] |
Integer |
|
purchase_invoice[details_attributes][description] |
String |
|
purchase_invoice[details_attributes][period] |
String |
String with a date range: |
purchase_invoice[details_attributes][price] |
Decimal |
Both a decimal and a string ‘10,95’ are accepted. |
purchase_invoice[details_attributes][amount] |
String |
|
purchase_invoice[details_attributes][tax_rate_id] |
Integer |
Should be a valid tax rate id. |
purchase_invoice[details_attributes][ledger_account_id] |
Integer |
Should be a valid ledger account id. |
purchase_invoice[details_attributes][project_id] |
Integer |
Should be a valid project id. |
purchase_invoice[details_attributes][row_order] |
Integer |
|
purchase_invoice[details_attributes][_destroy] |
Boolean |
Example: creates the purchase_invoice
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPOST \
-d '{"purchase_invoice":{"reference":"foobar","contact_id":446241581796689711,"details_attributes":{"0":{"description":"Lunch","price":20,"tax_rate_id":446241518964966551,"ledger_account_id":446241518911489155}}}}' \
https://moneybird.com/api/v2/123/documents/purchase_invoices.json
Response
Status: 201 Created
{
"id": "446241581955024702",
"administration_id": 123,
"contact_id": "446241581796689711",
"contact": {
"id": "446241581796689711",
"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": "2025-02-17T10:45:57.192Z",
"updated_at": "2025-02-17T10:45:57.192Z",
"version": 1739789157,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/7d7bc6f34fd307d61d36dc25c0f758f2135a06c4c0242c067e610d926f767ca0/all",
"notes": [],
"custom_fields": [],
"contact_people": [],
"archived": false
},
"reference": "foobar",
"date": "2025-02-17",
"due_date": null,
"entry_number": 3,
"state": "open",
"currency": "EUR",
"exchange_rate": "1.0",
"revenue_invoice": false,
"prices_are_incl_tax": false,
"origin": "api",
"paid_at": null,
"tax_number": "",
"total_price_excl_tax": "20.0",
"total_price_excl_tax_base": "20.0",
"total_price_incl_tax": "24.2",
"total_price_incl_tax_base": "24.2",
"created_at": "2025-02-17T10:45:57.343Z",
"updated_at": "2025-02-17T10:45:57.347Z",
"version": 1739789157,
"details": [
{
"id": "446241581957121855",
"administration_id": 123,
"tax_rate_id": "446241518964966551",
"ledger_account_id": "446241518911489155",
"project_id": null,
"product_id": null,
"amount": null,
"amount_decimal": "1.0",
"description": "Lunch",
"price": "20.0",
"period": null,
"row_order": 0,
"total_price_excl_tax_with_discount": "20.0",
"total_price_excl_tax_with_discount_base": "20.0",
"tax_report_reference": [
"NL/5b"
],
"mandatory_tax_text": null,
"created_at": "2025-02-17T10:45:57.345Z",
"updated_at": "2025-02-17T10:45:57.345Z",
"time_entries": []
}
],
"payments": [],
"notes": [],
"attachments": [],
"events": [
{
"administration_id": 123,
"user_id": 17397890963220,
"action": "document_saved",
"link_entity_id": null,
"link_entity_type": null,
"data": {},
"created_at": "2025-02-17T10:45:57.349Z",
"updated_at": "2025-02-17T10:45:57.349Z"
}
]
}
Example: requires all input
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPOST \
-d '{}' \
https://moneybird.com/api/v2/123/documents/purchase_invoices.json
Response
Status: 400 Bad Request
{
"error": "Purchase Invoice is required",
"symbolic": {
"purchase_invoice": "required"
}
}
Delete a purchase invoices
Parameters
| Parameter | Type | Description |
|---|---|---|
refresh_journal_entries |
Boolean |
Example: deletes the purchase_invoice
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XDELETE \
-d '{}' \
https://moneybird.com/api/v2/123/documents/purchase_invoices/446241583024572316.json
Response
Status: 200 OK
200
Update a purchase invoices
Parameters
| Parameter | Type | Description |
|---|---|---|
purchase_invoice[contact_id] |
Integer |
Required. Should be a valid contact id. |
purchase_invoice[reference] |
String |
Required. |
purchase_invoice[date] |
String |
Required Required. |
purchase_invoice[due_date] |
String |
|
purchase_invoice[currency] |
String |
ISO three-character currency code, e.g. EUR or USD. |
purchase_invoice[prices_are_incl_tax] |
Boolean |
|
purchase_invoice[revenue_invoice] |
Boolean |
|
purchase_invoice[details_attributes][id] |
Integer |
|
purchase_invoice[details_attributes][description] |
String |
|
purchase_invoice[details_attributes][period] |
String |
String with a date range: |
purchase_invoice[details_attributes][price] |
Decimal |
Both a decimal and a string ‘10,95’ are accepted. |
purchase_invoice[details_attributes][amount] |
String |
|
purchase_invoice[details_attributes][tax_rate_id] |
Integer |
Should be a valid tax rate id. |
purchase_invoice[details_attributes][ledger_account_id] |
Integer |
Should be a valid ledger account id. |
purchase_invoice[details_attributes][project_id] |
Integer |
Should be a valid project id. |
purchase_invoice[details_attributes][row_order] |
Integer |
|
purchase_invoice[details_attributes][_destroy] |
Boolean |
Example: updates the purchase_invoice
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPATCH \
-d '{"purchase_invoice":{"reference":"updated reference"}}' \
https://moneybird.com/api/v2/123/documents/purchase_invoices/446241582294763354.json
Response
Status: 200 OK
{
"id": "446241582294763354",
"administration_id": 123,
"contact_id": "446241582245480279",
"contact": {
"id": "446241582245480279",
"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": "2025-02-17T10:45:57.620Z",
"updated_at": "2025-02-17T10:45:57.620Z",
"version": 1739789157,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/03ea1e0975c61566ac51df5129cc07dab8502825a015e5e6ff5b0c55e573778c/all",
"notes": [],
"custom_fields": [],
"contact_people": [],
"archived": false
},
"reference": "updated reference",
"date": "2025-02-17",
"due_date": "2025-03-03",
"entry_number": 1,
"state": "open",
"currency": "EUR",
"exchange_rate": "1.0",
"revenue_invoice": false,
"prices_are_incl_tax": false,
"origin": null,
"paid_at": null,
"tax_number": "",
"total_price_excl_tax": "300.0",
"total_price_excl_tax_base": "300.0",
"total_price_incl_tax": "363.0",
"total_price_incl_tax_base": "363.0",
"created_at": "2025-02-17T10:45:57.668Z",
"updated_at": "2025-02-17T10:45:57.782Z",
"version": 1739789157,
"details": [
{
"id": "446241582296860507",
"administration_id": 123,
"tax_rate_id": "446241518964966551",
"ledger_account_id": "446241518911489155",
"project_id": null,
"product_id": null,
"amount": null,
"amount_decimal": "1.0",
"description": "Delivery Apple iPad",
"price": "300.0",
"period": null,
"row_order": 0,
"total_price_excl_tax_with_discount": "300.0",
"total_price_excl_tax_with_discount_base": "300.0",
"tax_report_reference": [
"NL/5b"
],
"mandatory_tax_text": null,
"created_at": "2025-02-17T10:45:57.669Z",
"updated_at": "2025-02-17T10:45:57.669Z",
"time_entries": []
}
],
"payments": [],
"notes": [],
"attachments": [],
"events": [
{
"administration_id": 123,
"user_id": 17397890963220,
"action": "document_saved",
"link_entity_id": null,
"link_entity_type": null,
"data": {},
"created_at": "2025-02-17T10:45:57.672Z",
"updated_at": "2025-02-17T10:45:57.672Z"
},
{
"administration_id": 123,
"user_id": 17397890963220,
"action": "document_updated",
"link_entity_id": null,
"link_entity_type": null,
"data": {
"changes": {
"reference": [
"2013-01234",
"updated reference"
],
"updated_at": [
"2025-02-17T11:45:57.671+01:00",
"2025-02-17T11:45:57.782+01:00"
]
}
},
"created_at": "2025-02-17T10:45:57.785Z",
"updated_at": "2025-02-17T10:45:57.785Z"
}
]
}
Example: updates invoice details
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPATCH \
-d '{"purchase_invoice":{"details_attributes":{"0":{"description":"New detail","price":99,"amount":1,"tax_rate_id":446241518964966551,"ledger_account_id":446241518911489155},"1":{"id":446241582564247411,"_destroy":true}}}}' \
https://moneybird.com/api/v2/123/documents/purchase_invoices/446241582561101682.json
Response
Status: 200 OK
{
"id": "446241582561101682",
"administration_id": 123,
"contact_id": "446241582513915759",
"contact": {
"id": "446241582513915759",
"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": "2025-02-17T10:45:57.877Z",
"updated_at": "2025-02-17T10:45:57.877Z",
"version": 1739789157,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/7b4c5c6e78d0a02a2a1bc852ce152673270e665601c7d9cadfa02b8ed2abfbf2/all",
"notes": [],
"custom_fields": [],
"contact_people": [],
"archived": false
},
"reference": "2013-01234",
"date": "2025-02-17",
"due_date": "2025-03-03",
"entry_number": 1,
"state": "open",
"currency": "EUR",
"exchange_rate": "1.0",
"revenue_invoice": false,
"prices_are_incl_tax": false,
"origin": null,
"paid_at": null,
"tax_number": "",
"total_price_excl_tax": "99.0",
"total_price_excl_tax_base": "99.0",
"total_price_incl_tax": "119.79",
"total_price_incl_tax_base": "119.79",
"created_at": "2025-02-17T10:45:57.922Z",
"updated_at": "2025-02-17T10:45:58.059Z",
"version": 1739789158,
"details": [
{
"id": "446241582702659454",
"administration_id": 123,
"tax_rate_id": "446241518964966551",
"ledger_account_id": "446241518911489155",
"project_id": null,
"product_id": null,
"amount": "1",
"amount_decimal": "1.0",
"description": "New detail",
"price": "99.0",
"period": null,
"row_order": 0,
"total_price_excl_tax_with_discount": "99.0",
"total_price_excl_tax_with_discount_base": "99.0",
"tax_report_reference": [
"NL/5b"
],
"mandatory_tax_text": null,
"created_at": "2025-02-17T10:45:58.057Z",
"updated_at": "2025-02-17T10:45:58.057Z",
"time_entries": []
}
],
"payments": [],
"notes": [],
"attachments": [],
"events": [
{
"administration_id": 123,
"user_id": 17397890963220,
"action": "document_saved",
"link_entity_id": null,
"link_entity_type": null,
"data": {},
"created_at": "2025-02-17T10:45:57.929Z",
"updated_at": "2025-02-17T10:45:57.929Z"
},
{
"administration_id": 123,
"user_id": 17397890963220,
"action": "document_updated",
"link_entity_id": null,
"link_entity_type": null,
"data": {
"changes": {
"total_price_excl_tax": [
"300.0",
"99.0"
],
"total_price_excl_tax_base": [
"300.0",
"99.0"
],
"total_price_incl_tax": [
"363.0",
"119.79"
],
"total_price_incl_tax_base": [
"363.0",
"119.79"
],
"cached_taxes": [
[
{
"tax_rate_id": "446241518964966551",
"report_reference": "NL/5b",
"payable": false,
"debit": "63.0",
"credit": 0
}
],
[
{
"tax_rate_id": "446241518964966551",
"report_reference": "NL/5b",
"payable": false,
"debit": "20.79",
"credit": 0
}
]
],
"updated_at": [
"2025-02-17T11:45:57.927+01:00",
"2025-02-17T11:45:58.042+01:00"
]
}
},
"created_at": "2025-02-17T10:45:58.059Z",
"updated_at": "2025-02-17T10:45:58.059Z"
}
]
}
DEPRECATED: Register a payment for a purchase invoice
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 |
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 |
Delete a payment
Add attachment to purchase 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/documents/purchase_invoices/446241583205975985/attachments.json
Response
Status: 200 OK
200
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.
Example: destroys an attachment
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XDELETE \
-d '{}' \
https://moneybird.com/api/v2/123/documents/purchase_invoices/446241586368480327/attachments/446241586540446803.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":446241581068977907,"todo":true}}' \
https://moneybird.com/api/v2/123/documents/purchase_invoices/446241581010257639/notes.json
Response
Status: 201 Created
{
"id": "446241581132941045",
"administration_id": 123,
"entity_id": "446241581010257639",
"entity_type": "Document",
"user_id": 17397890963220,
"assignee_id": "446241581068977907",
"todo": true,
"note": "Text of the note",
"completed_at": null,
"completed_by_id": null,
"todo_type": null,
"data": {},
"created_at": "2025-02-17T10:45:56.559Z",
"updated_at": "2025-02-17T10:45:56.559Z"
}
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/documents/purchase_invoices/446241581239895804/notes/446241581284984584.json