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"
    }
  }
}

PUT

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"
    }
  }
}

Authentication: API key OAuth 2.0
Scope: client_invoice.write

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.
active and suspended: frequency and start_date cannot change. Sending a different value returns a 422 with code frequency_not_updatable or start_date_not_updatable. Every other field can still change.
canceled and finished: the recurring invoice cannot be updated. A valid request returns a 412 with code recurring_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.

Authorizations

Authorization

string

header

required

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

X-Qonto-Staging-Token

string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

Path Parameters

string<uuid>

required

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.

client_id

string<uuid>

required

The client this recurring invoice bills.

Example:

"5c1f4e3a-9b7d-4a1e-8f2c-3d6b8a0e7f11"

start_date

string<date>

required

The date of the first occurrence. Cannot change once the recurring invoice is active or suspended.

Example:

"2030-01-01"

payment_terms_days

integer

required

Days between an occurrence's invoice date and its due date.

Required range: 0 <= x <= 365

Example:

30

frequency

object

required

Cannot change once the recurring invoice is active or suspended.

Show child attributes

bank_account

object

required

The bank account generated invoices are paid to, identified by IBAN.

Show child attributes

items

object[]

required

The line items billed on every occurrence. The whole list is replaced, and the new items get new ids.

Minimum array length: 1

Show child attributes

end_date

string<date> | null

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

string

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"

invoice_status

enum<string>

The status each generated invoice is created as. Reset to unpaid when left out, even if it was draft.

Available options:

draft,

unpaid

email_template

object

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

purchase_order

string | null

The purchase order reference printed on every generated invoice. Leave it out to remove it.

Maximum string length: 40

Example:

"PO-2026-001"

terms_and_conditions

string | null

The terms and conditions printed on every generated invoice. Leave them out to remove them.

Maximum string length: 50000

header

string | null

The header printed on every generated invoice. Leave it out to remove it.

Maximum string length: 50000

footer

string | null

The footer printed on every generated invoice. Leave it out to remove it.

Maximum string length: 50000

discount

object | null

An overall discount applied to every generated invoice. Leave it out to remove the discount.

Show child attributes

payment_link

object | null

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

payment_reporting

object

Italian payment reporting details. Required for organizations with an Italian legal country. For other organizations, leave them out to remove them.

Show child attributes

Response

Returns the updated recurring invoice.

recurring_invoice

object

required

Show child attributes

Introduction

Authentication

Organization & accounts

Transactions & statements

Transfers

Getting paid

Cards

Invoicing

Spend management

Cash flow

Webhooks

Partner endpoints

Update a recurring invoice

Authorizations

Headers

Path Parameters

Body

Response