Update a recurring invoice
curl --request PUT \
--url https://thirdparty.qonto.com/v2/recurring_invoices/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"client_id": "5c1f4e3a-9b7d-4a1e-8f2c-3d6b8a0e7f11",
"start_date": "2030-01-01",
"payment_terms_days": 30,
"frequency": {
"value": 1,
"recurrence": "monthly"
},
"bank_account": {
"iban": "FR7630006000011234567890189"
},
"items": [
{
"title": "Consulting",
"quantity": "1",
"unit_price": {
"value": "100.00",
"currency": "EUR"
},
"vat_rate": "0.2",
"description": "<string>",
"unit": "<string>",
"vat_exemption_code": "<string>"
}
],
"end_date": "2031-01-01",
"currency": "EUR",
"purchase_order": "PO-2026-001",
"terms_and_conditions": "<string>",
"header": "<string>",
"footer": "<string>",
"discount": {
"value": "0.1"
},
"payment_link": {
"methods": [
"credit_card"
]
}
}
'import requests
url = "https://thirdparty.qonto.com/v2/recurring_invoices/{id}"
payload = {
"client_id": "5c1f4e3a-9b7d-4a1e-8f2c-3d6b8a0e7f11",
"start_date": "2030-01-01",
"payment_terms_days": 30,
"frequency": {
"value": 1,
"recurrence": "monthly"
},
"bank_account": { "iban": "FR7630006000011234567890189" },
"items": [
{
"title": "Consulting",
"quantity": "1",
"unit_price": {
"value": "100.00",
"currency": "EUR"
},
"vat_rate": "0.2",
"description": "<string>",
"unit": "<string>",
"vat_exemption_code": "<string>"
}
],
"end_date": "2031-01-01",
"currency": "EUR",
"purchase_order": "PO-2026-001",
"terms_and_conditions": "<string>",
"header": "<string>",
"footer": "<string>",
"discount": { "value": "0.1" },
"payment_link": { "methods": ["credit_card"] }
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
client_id: '5c1f4e3a-9b7d-4a1e-8f2c-3d6b8a0e7f11',
start_date: '2030-01-01',
payment_terms_days: 30,
frequency: {value: 1, recurrence: 'monthly'},
bank_account: {iban: 'FR7630006000011234567890189'},
items: [
{
title: 'Consulting',
quantity: '1',
unit_price: {value: '100.00', currency: 'EUR'},
vat_rate: '0.2',
description: '<string>',
unit: '<string>',
vat_exemption_code: '<string>'
}
],
end_date: '2031-01-01',
currency: 'EUR',
purchase_order: 'PO-2026-001',
terms_and_conditions: '<string>',
header: '<string>',
footer: '<string>',
discount: {value: '0.1'},
payment_link: {methods: ['credit_card']}
})
};
fetch('https://thirdparty.qonto.com/v2/recurring_invoices/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://thirdparty.qonto.com/v2/recurring_invoices/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'client_id' => '5c1f4e3a-9b7d-4a1e-8f2c-3d6b8a0e7f11',
'start_date' => '2030-01-01',
'payment_terms_days' => 30,
'frequency' => [
'value' => 1,
'recurrence' => 'monthly'
],
'bank_account' => [
'iban' => 'FR7630006000011234567890189'
],
'items' => [
[
'title' => 'Consulting',
'quantity' => '1',
'unit_price' => [
'value' => '100.00',
'currency' => 'EUR'
],
'vat_rate' => '0.2',
'description' => '<string>',
'unit' => '<string>',
'vat_exemption_code' => '<string>'
]
],
'end_date' => '2031-01-01',
'currency' => 'EUR',
'purchase_order' => 'PO-2026-001',
'terms_and_conditions' => '<string>',
'header' => '<string>',
'footer' => '<string>',
'discount' => [
'value' => '0.1'
],
'payment_link' => [
'methods' => [
'credit_card'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://thirdparty.qonto.com/v2/recurring_invoices/{id}"
payload := strings.NewReader("{\n \"client_id\": \"5c1f4e3a-9b7d-4a1e-8f2c-3d6b8a0e7f11\",\n \"start_date\": \"2030-01-01\",\n \"payment_terms_days\": 30,\n \"frequency\": {\n \"value\": 1,\n \"recurrence\": \"monthly\"\n },\n \"bank_account\": {\n \"iban\": \"FR7630006000011234567890189\"\n },\n \"items\": [\n {\n \"title\": \"Consulting\",\n \"quantity\": \"1\",\n \"unit_price\": {\n \"value\": \"100.00\",\n \"currency\": \"EUR\"\n },\n \"vat_rate\": \"0.2\",\n \"description\": \"<string>\",\n \"unit\": \"<string>\",\n \"vat_exemption_code\": \"<string>\"\n }\n ],\n \"end_date\": \"2031-01-01\",\n \"currency\": \"EUR\",\n \"purchase_order\": \"PO-2026-001\",\n \"terms_and_conditions\": \"<string>\",\n \"header\": \"<string>\",\n \"footer\": \"<string>\",\n \"discount\": {\n \"value\": \"0.1\"\n },\n \"payment_link\": {\n \"methods\": [\n \"credit_card\"\n ]\n }\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://thirdparty.qonto.com/v2/recurring_invoices/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"client_id\": \"5c1f4e3a-9b7d-4a1e-8f2c-3d6b8a0e7f11\",\n \"start_date\": \"2030-01-01\",\n \"payment_terms_days\": 30,\n \"frequency\": {\n \"value\": 1,\n \"recurrence\": \"monthly\"\n },\n \"bank_account\": {\n \"iban\": \"FR7630006000011234567890189\"\n },\n \"items\": [\n {\n \"title\": \"Consulting\",\n \"quantity\": \"1\",\n \"unit_price\": {\n \"value\": \"100.00\",\n \"currency\": \"EUR\"\n },\n \"vat_rate\": \"0.2\",\n \"description\": \"<string>\",\n \"unit\": \"<string>\",\n \"vat_exemption_code\": \"<string>\"\n }\n ],\n \"end_date\": \"2031-01-01\",\n \"currency\": \"EUR\",\n \"purchase_order\": \"PO-2026-001\",\n \"terms_and_conditions\": \"<string>\",\n \"header\": \"<string>\",\n \"footer\": \"<string>\",\n \"discount\": {\n \"value\": \"0.1\"\n },\n \"payment_link\": {\n \"methods\": [\n \"credit_card\"\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://thirdparty.qonto.com/v2/recurring_invoices/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"client_id\": \"5c1f4e3a-9b7d-4a1e-8f2c-3d6b8a0e7f11\",\n \"start_date\": \"2030-01-01\",\n \"payment_terms_days\": 30,\n \"frequency\": {\n \"value\": 1,\n \"recurrence\": \"monthly\"\n },\n \"bank_account\": {\n \"iban\": \"FR7630006000011234567890189\"\n },\n \"items\": [\n {\n \"title\": \"Consulting\",\n \"quantity\": \"1\",\n \"unit_price\": {\n \"value\": \"100.00\",\n \"currency\": \"EUR\"\n },\n \"vat_rate\": \"0.2\",\n \"description\": \"<string>\",\n \"unit\": \"<string>\",\n \"vat_exemption_code\": \"<string>\"\n }\n ],\n \"end_date\": \"2031-01-01\",\n \"currency\": \"EUR\",\n \"purchase_order\": \"PO-2026-001\",\n \"terms_and_conditions\": \"<string>\",\n \"header\": \"<string>\",\n \"footer\": \"<string>\",\n \"discount\": {\n \"value\": \"0.1\"\n },\n \"payment_link\": {\n \"methods\": [\n \"credit_card\"\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"recurring_invoice": {
"id": "0198f2c1-8a3e-7c11-9f4d-2b6a7c8e9d01",
"status": "scheduled",
"client_id": "5c1f4e3a-9b7d-4a1e-8f2c-3d6b8a0e7f11",
"start_date": "2026-09-01",
"frequency": {
"value": 1,
"recurrence": "monthly"
},
"payment_terms_days": 30,
"invoice_status": "draft",
"purchase_order": "PO-2026-042",
"terms_and_conditions": "<string>",
"header": "<string>",
"footer": "<string>",
"currency": "EUR",
"amount_due": {
"value": "120.00",
"currency": "EUR"
},
"bank_account": {
"iban": "FR7630006000011234567890189",
"bic": "QNTOFRP1XXX"
},
"email_template": {
"send_to": [
"accounting@acme.com"
],
"copy_to_self": true,
"email_title": "Your invoice",
"email_body": "<string>"
},
"direct_debit_enabled": true,
"is_einvoice": true,
"items": [
{
"title": "Consulting",
"description": "<string>",
"quantity": "1",
"unit_price": {
"value": "100.00",
"currency": "EUR"
},
"vat_rate": "0.2",
"unit": "hour",
"vat_exemption_code": "<string>",
"discount": {
"type": "percentage",
"value": "0.1000"
}
}
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"client_name": "ACME SAS",
"end_date": "2023-12-25",
"next_invoice_date": "2026-10-01",
"prev_invoice_date": "2023-12-25",
"discount": {
"type": "percentage",
"value": "0.1000"
},
"payment_link": {
"methods": [
"credit_card"
]
},
"payment_reporting": {
"method": "MP01",
"conditions": "TP01"
}
}
}Recurring Invoices
Update a recurring invoice
OAuth scope: client_invoice.write
Replaces the recurring invoice identified by the id path parameter. The body is the complete recurring invoice. To change one field, send the current values of all the others alongside it. GET /v2/recurring_invoices/{id} returns them.
Leaving a field out clears or resets it. purchase_order, terms_and_conditions, header, footer, end_date, discount, email_template, payment_link and payment_reporting are removed if the body does not carry them, even when they were set in the Qonto app. currency is reset to EUR and invoice_status to unpaid. items is replaced as a whole, and the new items get new ids.
Settings this endpoint does not accept are kept: direct debit, welfare fund, withholding tax, stamp duty, e-invoicing and the attachment.
What you can change depends on the current status.
scheduled: every field can change.activeandsuspended:frequencyandstart_datecannot change. Sending a different value returns a422withcodefrequency_not_updatableorstart_date_not_updatable. Every other field can still change.canceledandfinished: the recurring invoice cannot be updated. A valid request returns a412withcoderecurring_invoice_not_updatable.
Updating a scheduled recurring invoice whose start_date is today generates an invoice immediately, and the recurring invoice becomes active. The response does not include the id of that invoice.
Organizations with an Italian legal country must send payment_reporting. Without it the request returns a 422.
PUT
/
v2
/
recurring_invoices
/
{id}
Update a recurring invoice
curl --request PUT \
--url https://thirdparty.qonto.com/v2/recurring_invoices/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"client_id": "5c1f4e3a-9b7d-4a1e-8f2c-3d6b8a0e7f11",
"start_date": "2030-01-01",
"payment_terms_days": 30,
"frequency": {
"value": 1,
"recurrence": "monthly"
},
"bank_account": {
"iban": "FR7630006000011234567890189"
},
"items": [
{
"title": "Consulting",
"quantity": "1",
"unit_price": {
"value": "100.00",
"currency": "EUR"
},
"vat_rate": "0.2",
"description": "<string>",
"unit": "<string>",
"vat_exemption_code": "<string>"
}
],
"end_date": "2031-01-01",
"currency": "EUR",
"purchase_order": "PO-2026-001",
"terms_and_conditions": "<string>",
"header": "<string>",
"footer": "<string>",
"discount": {
"value": "0.1"
},
"payment_link": {
"methods": [
"credit_card"
]
}
}
'import requests
url = "https://thirdparty.qonto.com/v2/recurring_invoices/{id}"
payload = {
"client_id": "5c1f4e3a-9b7d-4a1e-8f2c-3d6b8a0e7f11",
"start_date": "2030-01-01",
"payment_terms_days": 30,
"frequency": {
"value": 1,
"recurrence": "monthly"
},
"bank_account": { "iban": "FR7630006000011234567890189" },
"items": [
{
"title": "Consulting",
"quantity": "1",
"unit_price": {
"value": "100.00",
"currency": "EUR"
},
"vat_rate": "0.2",
"description": "<string>",
"unit": "<string>",
"vat_exemption_code": "<string>"
}
],
"end_date": "2031-01-01",
"currency": "EUR",
"purchase_order": "PO-2026-001",
"terms_and_conditions": "<string>",
"header": "<string>",
"footer": "<string>",
"discount": { "value": "0.1" },
"payment_link": { "methods": ["credit_card"] }
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
client_id: '5c1f4e3a-9b7d-4a1e-8f2c-3d6b8a0e7f11',
start_date: '2030-01-01',
payment_terms_days: 30,
frequency: {value: 1, recurrence: 'monthly'},
bank_account: {iban: 'FR7630006000011234567890189'},
items: [
{
title: 'Consulting',
quantity: '1',
unit_price: {value: '100.00', currency: 'EUR'},
vat_rate: '0.2',
description: '<string>',
unit: '<string>',
vat_exemption_code: '<string>'
}
],
end_date: '2031-01-01',
currency: 'EUR',
purchase_order: 'PO-2026-001',
terms_and_conditions: '<string>',
header: '<string>',
footer: '<string>',
discount: {value: '0.1'},
payment_link: {methods: ['credit_card']}
})
};
fetch('https://thirdparty.qonto.com/v2/recurring_invoices/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://thirdparty.qonto.com/v2/recurring_invoices/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'client_id' => '5c1f4e3a-9b7d-4a1e-8f2c-3d6b8a0e7f11',
'start_date' => '2030-01-01',
'payment_terms_days' => 30,
'frequency' => [
'value' => 1,
'recurrence' => 'monthly'
],
'bank_account' => [
'iban' => 'FR7630006000011234567890189'
],
'items' => [
[
'title' => 'Consulting',
'quantity' => '1',
'unit_price' => [
'value' => '100.00',
'currency' => 'EUR'
],
'vat_rate' => '0.2',
'description' => '<string>',
'unit' => '<string>',
'vat_exemption_code' => '<string>'
]
],
'end_date' => '2031-01-01',
'currency' => 'EUR',
'purchase_order' => 'PO-2026-001',
'terms_and_conditions' => '<string>',
'header' => '<string>',
'footer' => '<string>',
'discount' => [
'value' => '0.1'
],
'payment_link' => [
'methods' => [
'credit_card'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://thirdparty.qonto.com/v2/recurring_invoices/{id}"
payload := strings.NewReader("{\n \"client_id\": \"5c1f4e3a-9b7d-4a1e-8f2c-3d6b8a0e7f11\",\n \"start_date\": \"2030-01-01\",\n \"payment_terms_days\": 30,\n \"frequency\": {\n \"value\": 1,\n \"recurrence\": \"monthly\"\n },\n \"bank_account\": {\n \"iban\": \"FR7630006000011234567890189\"\n },\n \"items\": [\n {\n \"title\": \"Consulting\",\n \"quantity\": \"1\",\n \"unit_price\": {\n \"value\": \"100.00\",\n \"currency\": \"EUR\"\n },\n \"vat_rate\": \"0.2\",\n \"description\": \"<string>\",\n \"unit\": \"<string>\",\n \"vat_exemption_code\": \"<string>\"\n }\n ],\n \"end_date\": \"2031-01-01\",\n \"currency\": \"EUR\",\n \"purchase_order\": \"PO-2026-001\",\n \"terms_and_conditions\": \"<string>\",\n \"header\": \"<string>\",\n \"footer\": \"<string>\",\n \"discount\": {\n \"value\": \"0.1\"\n },\n \"payment_link\": {\n \"methods\": [\n \"credit_card\"\n ]\n }\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://thirdparty.qonto.com/v2/recurring_invoices/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"client_id\": \"5c1f4e3a-9b7d-4a1e-8f2c-3d6b8a0e7f11\",\n \"start_date\": \"2030-01-01\",\n \"payment_terms_days\": 30,\n \"frequency\": {\n \"value\": 1,\n \"recurrence\": \"monthly\"\n },\n \"bank_account\": {\n \"iban\": \"FR7630006000011234567890189\"\n },\n \"items\": [\n {\n \"title\": \"Consulting\",\n \"quantity\": \"1\",\n \"unit_price\": {\n \"value\": \"100.00\",\n \"currency\": \"EUR\"\n },\n \"vat_rate\": \"0.2\",\n \"description\": \"<string>\",\n \"unit\": \"<string>\",\n \"vat_exemption_code\": \"<string>\"\n }\n ],\n \"end_date\": \"2031-01-01\",\n \"currency\": \"EUR\",\n \"purchase_order\": \"PO-2026-001\",\n \"terms_and_conditions\": \"<string>\",\n \"header\": \"<string>\",\n \"footer\": \"<string>\",\n \"discount\": {\n \"value\": \"0.1\"\n },\n \"payment_link\": {\n \"methods\": [\n \"credit_card\"\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://thirdparty.qonto.com/v2/recurring_invoices/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"client_id\": \"5c1f4e3a-9b7d-4a1e-8f2c-3d6b8a0e7f11\",\n \"start_date\": \"2030-01-01\",\n \"payment_terms_days\": 30,\n \"frequency\": {\n \"value\": 1,\n \"recurrence\": \"monthly\"\n },\n \"bank_account\": {\n \"iban\": \"FR7630006000011234567890189\"\n },\n \"items\": [\n {\n \"title\": \"Consulting\",\n \"quantity\": \"1\",\n \"unit_price\": {\n \"value\": \"100.00\",\n \"currency\": \"EUR\"\n },\n \"vat_rate\": \"0.2\",\n \"description\": \"<string>\",\n \"unit\": \"<string>\",\n \"vat_exemption_code\": \"<string>\"\n }\n ],\n \"end_date\": \"2031-01-01\",\n \"currency\": \"EUR\",\n \"purchase_order\": \"PO-2026-001\",\n \"terms_and_conditions\": \"<string>\",\n \"header\": \"<string>\",\n \"footer\": \"<string>\",\n \"discount\": {\n \"value\": \"0.1\"\n },\n \"payment_link\": {\n \"methods\": [\n \"credit_card\"\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"recurring_invoice": {
"id": "0198f2c1-8a3e-7c11-9f4d-2b6a7c8e9d01",
"status": "scheduled",
"client_id": "5c1f4e3a-9b7d-4a1e-8f2c-3d6b8a0e7f11",
"start_date": "2026-09-01",
"frequency": {
"value": 1,
"recurrence": "monthly"
},
"payment_terms_days": 30,
"invoice_status": "draft",
"purchase_order": "PO-2026-042",
"terms_and_conditions": "<string>",
"header": "<string>",
"footer": "<string>",
"currency": "EUR",
"amount_due": {
"value": "120.00",
"currency": "EUR"
},
"bank_account": {
"iban": "FR7630006000011234567890189",
"bic": "QNTOFRP1XXX"
},
"email_template": {
"send_to": [
"accounting@acme.com"
],
"copy_to_self": true,
"email_title": "Your invoice",
"email_body": "<string>"
},
"direct_debit_enabled": true,
"is_einvoice": true,
"items": [
{
"title": "Consulting",
"description": "<string>",
"quantity": "1",
"unit_price": {
"value": "100.00",
"currency": "EUR"
},
"vat_rate": "0.2",
"unit": "hour",
"vat_exemption_code": "<string>",
"discount": {
"type": "percentage",
"value": "0.1000"
}
}
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"client_name": "ACME SAS",
"end_date": "2023-12-25",
"next_invoice_date": "2026-10-01",
"prev_invoice_date": "2023-12-25",
"discount": {
"type": "percentage",
"value": "0.1000"
},
"payment_link": {
"methods": [
"credit_card"
]
},
"payment_reporting": {
"method": "MP01",
"conditions": "TP01"
}
}
}Authorizations
OAuthSecretKey
Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.
Headers
Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.
Path Parameters
The unique identifier of the recurring invoice.
Body
application/json
The complete recurring invoice. A field you leave out is cleared or reset to its default, so send every field you want to keep. Settings this endpoint does not accept, such as direct debit, welfare fund, withholding tax and stamp duty, are kept as they are.
The client this recurring invoice bills.
Example:
"5c1f4e3a-9b7d-4a1e-8f2c-3d6b8a0e7f11"
The date of the first occurrence. Cannot change once the recurring invoice is active or suspended.
Example:
"2030-01-01"
Days between an occurrence's invoice date and its due date.
Required range:
0 <= x <= 365Example:
30
Cannot change once the recurring invoice is active or suspended.
Show child attributes
Show child attributes
The bank account generated invoices are paid to, identified by IBAN.
Show child attributes
Show child attributes
The line items billed on every occurrence. The whole list is replaced, and the new items get new ids.
Minimum array length:
1Show child attributes
Show child attributes
The date after which no further invoice is generated. Must be on or after start_date. Leave it out to remove it.
Example:
"2031-01-01"
Currency for the recurring invoice and its items, as an ISO 4217 trigram. Every item's currency has to match it. Reset to EUR when left out, even if the recurring invoice used another currency.
Example:
"EUR"
The status each generated invoice is created as. Reset to unpaid when left out, even if it was draft.
Available options:
draft, unpaid How each generated invoice is emailed to the client. Required when invoice_status is unpaid. Leave it out to remove it, which is only valid when invoice_status is draft.
Show child attributes
Show child attributes
The purchase order reference printed on every generated invoice. Leave it out to remove it.
Maximum string length:
40Example:
"PO-2026-001"
The terms and conditions printed on every generated invoice. Leave them out to remove them.
Maximum string length:
50000The header printed on every generated invoice. Leave it out to remove it.
Maximum string length:
50000The footer printed on every generated invoice. Leave it out to remove it.
Maximum string length:
50000An overall discount applied to every generated invoice. Leave it out to remove the discount.
Show child attributes
Show child attributes
The payment methods offered on every generated invoice. Leave it out, or send an empty methods list, to remove the payment link.
Show child attributes
Show child attributes
Italian payment reporting details. Required for organizations with an Italian legal country. For other organizations, leave them out to remove them.
Show child attributes
Show child attributes
Response
Returns the updated recurring invoice.
Show child attributes
Show child attributes
Was this page helpful?