Subscriptions
List all subscriptions
Lists all subscriptions for the given contact.
Parameters
| Parameter | Type | Description |
|---|---|---|
contact_id |
Integer |
Required |
Example: lists all subscriptions for a contact
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/subscriptions.json?contact_id=446241821004138113
Response
Status: 200 OK
[
{
"id": "446241821045032581",
"administration_id": 123,
"start_date": "2017-01-01",
"end_date": null,
"frequency": 1,
"frequency_type": "month",
"reference": null,
"cancelled_at": null,
"product_id": "446241821028255363",
"product": {
"id": "446241821028255363",
"administration_id": 123,
"description": "My product description",
"title": null,
"identifier": null,
"price": "20.0",
"currency": "EUR",
"frequency": 1,
"frequency_type": "month",
"tax_rate_id": "446241518957626516",
"ledger_account_id": "446241518911489156",
"created_at": "2025-02-17T10:49:45.341Z",
"updated_at": "2025-02-17T10:49:45.341Z"
},
"contact_id": "446241821004138113",
"contact": {
"id": "446241821004138113",
"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:49:45.318Z",
"updated_at": "2025-02-17T10:49:45.318Z",
"version": 1739789385,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/f2a2d36010a4fa665440179591a747de4bc8c36f07b16c82c23d3b6625214bdc/all",
"notes": [],
"custom_fields": [],
"contact_people": [],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"subscription_products": [
{
"start_date": "2017-01-01",
"end_date": null,
"product_id": "446241821028255363",
"product": {
"id": "446241821028255363",
"administration_id": 123,
"description": "My product description",
"title": null,
"identifier": null,
"price": "20.0",
"currency": "EUR",
"frequency": 1,
"frequency_type": "month",
"tax_rate_id": "446241518957626516",
"ledger_account_id": "446241518911489156",
"created_at": "2025-02-17T10:49:45.341Z",
"updated_at": "2025-02-17T10:49:45.341Z"
},
"amount": "1 x",
"discount": "0.0"
}
],
"recurring_sales_invoice_id": "446241821092218504"
}
]
Create a new subscription
Starts a new subscription for the given contact. The product_id points to a product with a frequency, price and description.
A recurring sales invoice is automatically created to bill the contact for the given frequency. The first invoice will be sent on the
start date, but no sooner than tomorrow. The reference will be added to the sales invoices.
Optionally you can create a subscription with a different frequency than stored in the product. Make sure the frequency of the product and the provided frequency are compatible. E.g. you can bill a monthly product yearly.
Parameters
| Parameter | Type | Description |
|---|---|---|
subscription[start_date] |
Date |
Required |
subscription[product_id] |
Integer |
Required Should be a valid product id. |
subscription[amount] |
String |
|
subscription[discount] |
Decimal |
Both a decimal and a string ‘10,95’ are accepted. |
subscription[contact_id] |
Integer |
Should be a valid contact id. |
subscription[contact_person_id] |
Integer |
Should be a valid contact person id. |
subscription[end_date] |
Date |
|
subscription[reference] |
String |
|
subscription[document_style_id] |
Integer |
Should be a valid document style id. |
subscription[frequency] |
Integer |
|
subscription[frequency_type] |
String |
|
subscription[mergeable] |
Boolean |
|
subscription[prices_are_incl_tax] |
Boolean |
Example: creates a new subscription for the contact
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPOST \
-d '{"subscription":{"start_date":"2025-02-18","contact_id":446241821930030770,"product_id":446241821948905140,"reference":"moneybird.nl","discount":10,"amount":"5x"}}' \
https://moneybird.com/api/v2/123/subscriptions.json
Response
Status: 201 Created
{
"id": "446241822009722550",
"administration_id": 123,
"start_date": "2025-02-18",
"end_date": null,
"frequency": 1,
"frequency_type": "month",
"reference": "moneybird.nl",
"cancelled_at": null,
"product_id": "446241821948905140",
"product": {
"id": "446241821948905140",
"administration_id": 123,
"description": "My product description",
"title": null,
"identifier": null,
"price": "20.0",
"currency": "EUR",
"frequency": 1,
"frequency_type": "month",
"tax_rate_id": "446241518957626516",
"ledger_account_id": "446241518911489156",
"created_at": "2025-02-17T10:49:46.220Z",
"updated_at": "2025-02-17T10:49:46.220Z"
},
"contact_id": "446241821930030770",
"contact": {
"id": "446241821930030770",
"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:49:46.201Z",
"updated_at": "2025-02-17T10:49:46.201Z",
"version": 1739789386,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/293c1fd6f1b0eb899f27a96d796a0ef026be2e2d7f73f3a3fb9e2dfdb659d47f/all",
"notes": [],
"custom_fields": [],
"contact_people": [],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"subscription_products": [
{
"start_date": "2025-02-18",
"end_date": null,
"product_id": "446241821948905140",
"product": {
"id": "446241821948905140",
"administration_id": 123,
"description": "My product description",
"title": null,
"identifier": null,
"price": "20.0",
"currency": "EUR",
"frequency": 1,
"frequency_type": "month",
"tax_rate_id": "446241518957626516",
"ledger_account_id": "446241518911489156",
"created_at": "2025-02-17T10:49:46.220Z",
"updated_at": "2025-02-17T10:49:46.220Z"
},
"amount": "5x",
"discount": "10.0"
}
],
"recurring_sales_invoice_id": "446241822051665593"
}
Get subscription
Get a subscription.
Example: returns a subscription
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/subscriptions/446241822394549969.json?
Response
Status: 200 OK
{
"id": "446241822394549969",
"administration_id": 123,
"start_date": "2017-01-01",
"end_date": null,
"frequency": 1,
"frequency_type": "month",
"reference": null,
"cancelled_at": null,
"product_id": "446241822380918479",
"product": {
"id": "446241822380918479",
"administration_id": 123,
"description": "My product description",
"title": null,
"identifier": null,
"price": "20.0",
"currency": "EUR",
"frequency": 1,
"frequency_type": "month",
"tax_rate_id": "446241518957626516",
"ledger_account_id": "446241518911489156",
"created_at": "2025-02-17T10:49:46.631Z",
"updated_at": "2025-02-17T10:49:46.631Z"
},
"contact_id": "446241822364141261",
"contact": {
"id": "446241822364141261",
"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:49:46.614Z",
"updated_at": "2025-02-17T10:49:46.614Z",
"version": 1739789386,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/68dc9eb2000e27637ac2eba949abdbd99d5cb9f02606b6ba01152cbd4b512df0/all",
"notes": [],
"custom_fields": [],
"contact_people": [],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"subscription_products": [
{
"start_date": "2017-01-01",
"end_date": null,
"product_id": "446241822380918479",
"product": {
"id": "446241822380918479",
"administration_id": 123,
"description": "My product description",
"title": null,
"identifier": null,
"price": "20.0",
"currency": "EUR",
"frequency": 1,
"frequency_type": "month",
"tax_rate_id": "446241518957626516",
"ledger_account_id": "446241518911489156",
"created_at": "2025-02-17T10:49:46.631Z",
"updated_at": "2025-02-17T10:49:46.631Z"
},
"amount": "1 x",
"discount": "0.0"
}
],
"recurring_sales_invoice_id": "446241822438590164"
}
Example: returns 404 when the subscription does not exist
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/subscriptions/12345.json?
Response
Status: 404 Not Found
{
"error": "record not found",
"symbolic": {
"id": "not_found"
}
}
Update a subscription
Updates the product the contact is subscribed to. This will automatically calculate the differences between the product prices and create a one off sales invoice to bill the extra charge for the remaining billing period.
Optionally you can provide a start date for the product change to become active.
Parameters
| Parameter | Type | Description |
|---|---|---|
subscription[contact_person_id] |
String |
Should be a valid contact person id. |
subscription[document_style_id] |
Integer |
Should be a valid document style id. |
subscription[reference] |
String |
|
subscription[mergeable] |
Boolean |
|
subscription[prices_are_incl_tax] |
Boolean |
|
subscription[product_id] |
Integer |
Should be a valid product id. |
subscription[start_date] |
Date |
|
subscription[amount] |
String |
|
subscription[discount] |
Decimal |
Both a decimal and a string ‘10,95’ are accepted. |
Example: updates a subscription
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPATCH \
-d '{"subscription":{"product_id":446241823069832939,"discount":10,"amount":"3 x"}}' \
https://moneybird.com/api/v2/123/subscriptions/446241823112824563.json
Response
Status: 200 OK
{
"id": "446241823112824563",
"administration_id": 123,
"start_date": "2017-01-01",
"end_date": null,
"frequency": 1,
"frequency_type": "month",
"reference": null,
"cancelled_at": null,
"product_id": "446241823069832939",
"product": {
"id": "446241823069832939",
"administration_id": 123,
"description": "My product description",
"title": null,
"identifier": null,
"price": "30.0",
"currency": "EUR",
"frequency": 1,
"frequency_type": "month",
"tax_rate_id": "446241518957626516",
"ledger_account_id": "446241518911489156",
"created_at": "2025-02-17T10:49:47.288Z",
"updated_at": "2025-02-17T10:49:47.288Z"
},
"contact_id": "446241823088707311",
"contact": {
"id": "446241823088707311",
"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:49:47.303Z",
"updated_at": "2025-02-17T10:49:47.303Z",
"version": 1739789387,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/57e2d8ac0cd95ca89c3fc702468e57d2b765656863b0bf759ec0ed5e77131a5d/all",
"notes": [],
"custom_fields": [],
"contact_people": [],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"subscription_products": [
{
"start_date": "2017-01-01",
"end_date": "2025-02-16",
"product_id": "446241823101290225",
"product": {
"id": "446241823101290225",
"administration_id": 123,
"description": "My product description",
"title": null,
"identifier": null,
"price": "20.0",
"currency": "EUR",
"frequency": 1,
"frequency_type": "month",
"tax_rate_id": "446241518957626516",
"ledger_account_id": "446241518911489156",
"created_at": "2025-02-17T10:49:47.319Z",
"updated_at": "2025-02-17T10:49:47.319Z"
},
"amount": "1 x",
"discount": "0.0"
},
{
"start_date": "2025-02-17",
"end_date": null,
"product_id": "446241823069832939",
"product": {
"id": "446241823069832939",
"administration_id": 123,
"description": "My product description",
"title": null,
"identifier": null,
"price": "30.0",
"currency": "EUR",
"frequency": 1,
"frequency_type": "month",
"tax_rate_id": "446241518957626516",
"ledger_account_id": "446241518911489156",
"created_at": "2025-02-17T10:49:47.288Z",
"updated_at": "2025-02-17T10:49:47.288Z"
},
"amount": "3 x",
"discount": "10.0"
}
],
"recurring_sales_invoice_id": "446241823156864758"
}
Example: returns a 404 if the subscription couldn't be found
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPATCH \
-d '{"subscription":{"product_id":446241823727290120}}' \
https://moneybird.com/api/v2/123/subscriptions/0.json
Response
Status: 404 Not Found
{
"error": "record not found",
"symbolic": {
"id": "not_found"
}
}
Cancel a subscription
Cancels the subscription. Stops the recurring sales invoice for the contact. Optionally
you can provide an end_date to stop the subscription on a future date.
Parameters
| Parameter | Type | Description |
|---|---|---|
subscription[end_date] |
Date |
Example: cancels a subscription for the contact
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XDELETE \
-d '{"subscription":{"end_date":"2025-02-19"}}' \
https://moneybird.com/api/v2/123/subscriptions/446241824405718831.json
Response
Status: 200 OK
{
"id": "446241824405718831",
"administration_id": 123,
"start_date": "2017-01-01",
"end_date": "2025-02-19",
"frequency": 1,
"frequency_type": "month",
"reference": null,
"cancelled_at": "2025-02-17T10:49:48.965Z",
"product_id": "446241824396281645",
"product": {
"id": "446241824396281645",
"administration_id": 123,
"description": "My product description",
"title": null,
"identifier": null,
"price": "20.0",
"currency": "EUR",
"frequency": 1,
"frequency_type": "month",
"tax_rate_id": "446241518957626516",
"ledger_account_id": "446241518911489156",
"created_at": "2025-02-17T10:49:48.553Z",
"updated_at": "2025-02-17T10:49:48.553Z"
},
"contact_id": "446241824382650155",
"contact": {
"id": "446241824382650155",
"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:49:48.540Z",
"updated_at": "2025-02-17T10:49:48.540Z",
"version": 1739789388,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/49e1a68d237e0bea9354d5afe8dd6c69b6ce739de7b55a0620245137662e46b6/all",
"notes": [],
"custom_fields": [],
"contact_people": [],
"archived": false
},
"contact_person_id": null,
"contact_person": null,
"subscription_products": [
{
"start_date": "2017-01-01",
"end_date": "2025-02-19",
"product_id": "446241824396281645",
"product": {
"id": "446241824396281645",
"administration_id": 123,
"description": "My product description",
"title": null,
"identifier": null,
"price": "20.0",
"currency": "EUR",
"frequency": 1,
"frequency_type": "month",
"tax_rate_id": "446241518957626516",
"ledger_account_id": "446241518911489156",
"created_at": "2025-02-17T10:49:48.553Z",
"updated_at": "2025-02-17T10:49:48.553Z"
},
"amount": "1 x",
"discount": "0.0"
}
],
"recurring_sales_invoice_id": "446241824438224690"
}
Create and schedule an invoice to be sent together with the subscription
Besides the recurring sales invoice for the subscription, you sometimes need to bill separate costs like usage based charges. Ideally you want these costs to be on the same invoice as the subscription invoice. This endpoint allows you to put extra invoice details on the subscription invoice.
This endpoint creates a new sales invoice and schedules it for sending on the same date as the next subscription invoice. During sending, Moneybird will merge both the scheduled invoice and the subscription invoice. This means the contact will receive one sales invoice with multiple invoice details, both from the subscription and from the one off sales invoice.
Parameters
| Parameter | Type | Description |
|---|---|---|
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][product_id] |
Integer |
Should be a valid product id. |
sales_invoice[details_attributes][row_order] |
Integer |
|
sales_invoice[invoice_date] |
Date |
Example: creates a sales invoice
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPOST \
-d '{"sales_invoice":{"details_attributes":{"0":{"description":"Extra costs subscription","price":"10.5"}}}}' \
https://moneybird.com/api/v2/123/subscriptions/446241825545520987/create_and_schedule_one_off_sales_invoice.json
Response
Status: 201 Created
{
"id": "446241826005845864",
"administration_id": 123,
"contact_id": "446241825498335063",
"contact": {
"id": "446241825498335063",
"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:49:49.582Z",
"updated_at": "2025-02-17T10:49:49.582Z",
"version": 1739789389,
"sales_invoices_url": "https://moneybird.dev/123/sales_invoices/5950b968b7c08e8ecd60bb111b3e674800e0fee8217bc2f0f99ca024ee2c72c0/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": "446241519125398683",
"document_style_id": "446241519249130660",
"identity_id": "446241518989083802",
"draft_id": 2,
"state": "scheduled",
"invoice_date": "2025-03-01",
"due_date": "2025-03-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": null,
"language": "nl",
"currency": "EUR",
"discount": "0.0",
"original_sales_invoice_id": null,
"paused": false,
"paid_at": null,
"sent_at": null,
"created_at": "2025-02-17T10:49:49.582Z",
"updated_at": "2025-02-17T10:49:49.582Z",
"public_view_code": null,
"public_view_code_expires_at": null,
"version": 1739789389,
"details": [
{
"id": "446241826010040169",
"administration_id": 123,
"tax_rate_id": "446241518957626516",
"ledger_account_id": "446241518911489156",
"project_id": null,
"product_id": null,
"amount": null,
"amount_decimal": "1.0",
"description": "Extra costs subscription",
"price": "10.5",
"period": null,
"row_order": 0,
"total_price_excl_tax_with_discount": "10.5",
"total_price_excl_tax_with_discount_base": "10.5",
"tax_report_reference": [
"NL/1a"
],
"mandatory_tax_text": null,
"created_at": "2025-02-17T10:49:49.582Z",
"updated_at": "2025-02-17T10:49:49.582Z",
"time_entries": []
}
],
"payments": [],
"total_paid": "0.0",
"total_unpaid": "12.71",
"total_unpaid_base": "12.71",
"prices_are_incl_tax": false,
"total_price_excl_tax": "10.5",
"total_price_excl_tax_base": "10.5",
"total_price_incl_tax": "12.71",
"total_price_incl_tax_base": "12.71",
"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/external/5950b968b7c08e8ecd60bb111b3e674800e0fee8217bc2f0f99ca024ee2c72c0/d9db82af25049cf75b417b0b8d054065ea4d1a9dcaa7a4768e2df526f8254612/sales_invoice",
"payment_url": "http://moneybird.dev/123/external/5950b968b7c08e8ecd60bb111b3e674800e0fee8217bc2f0f99ca024ee2c72c0/d9db82af25049cf75b417b0b8d054065ea4d1a9dcaa7a4768e2df526f8254612/sales_invoice",
"custom_fields": [],
"notes": [],
"attachments": [],
"events": [
{
"administration_id": 123,
"user_id": 17397890963220,
"action": "sales_invoice_created",
"link_entity_id": null,
"link_entity_type": null,
"data": {},
"created_at": "2025-02-17T10:49:49.582Z",
"updated_at": "2025-02-17T10:49:49.582Z"
},
{
"administration_id": 123,
"user_id": 17397890963220,
"action": "sales_invoice_state_changed_to_scheduled",
"link_entity_id": null,
"link_entity_type": null,
"data": {},
"created_at": "2025-02-17T10:49:49.582Z",
"updated_at": "2025-02-17T10:49:49.582Z"
}
],
"tax_totals": [
{
"tax_rate_id": "446241518957626516",
"taxable_amount": "10.5",
"taxable_amount_base": "10.5",
"tax_amount": "2.21",
"tax_amount_base": "2.21"
}
]
}
Create an additional charge to be invoiced together with the subscription
At the end of the current subscription period, the additional charges are merged where possible and an invoice will be created for them. The invoice will be scheduled for sending together with the subscription invoice, so that they are merged on sending.
Example: create a usage charge
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XPOST \
-d '{"product_id":446241826757674883,"amount":"5 x","price":100.0,"period":"20210601..20210630","description":"Transaction Costs"}' \
https://moneybird.com/api/v2/123/subscriptions/446241826793326473/additional_charges
Response
Status: 201 Created
{
"id": "446241827057567638",
"administration_id": 123,
"contact_id": null,
"subscription_id": "446241826793326473",
"product_id": "446241826757674883",
"detail_id": null,
"amount": "5 x",
"price": "100.0",
"period": "202106..202106",
"description": "Transaction Costs"
}
Get additional charges
Get the additional charges of the given subscription.
Parameters
| Parameter | Type | Description |
|---|---|---|
include_billed |
Boolean |
If true, includes the additional charges that have already been billed. Default is false. |
Example: views additional charges of a subscription
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/subscriptions/446241827148793757/additional_charges.json?
Response
Status: 200 OK
[
{
"id": "446241827461269420",
"administration_id": 123,
"contact_id": null,
"subscription_id": "446241827148793757",
"product_id": "446241827450783658",
"detail_id": null,
"amount": "5 x",
"price": "100.0",
"period": "202106..202106",
"description": "Transaction Costs"
}
]
Example: does return billed additional charges if include_billed is true
Request
curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
-XGET \
https://moneybird.com/api/v2/123/subscriptions/446241829038326793/additional_charges.json?include_billed=true
Response
Status: 200 OK
[
{
"id": "446241829260624920",
"administration_id": 123,
"contact_id": null,
"subscription_id": "446241829038326793",
"product_id": "446241829249090582",
"detail_id": null,
"amount": "5 x",
"price": "100.0",
"period": "202106..202106",
"description": "Transaction Costs"
},
{
"id": "446241829279499291",
"administration_id": 123,
"contact_id": null,
"subscription_id": "446241829038326793",
"product_id": "446241829270062105",
"detail_id": "446241829319345181",
"amount": "5 x",
"price": "100.0",
"period": "202106..202106",
"description": "Transaction Costs"
}
]