Replace an invoice

PUT/invoices/{invoice}

Replaces every field of the invoice with the request body, under the same rules as create. Always resend the current invoice_number: when it is omitted the invoice is renumbered from the series counter. Items, payment options and custom fields are rewritten, totals recalculated and the PDF regenerated. Fires the invoice.updated webhook.

Authorization

bearerAuth

AuthorizationBearer <token>

Business token created in the app under Settings, Integrations, API. The token is scoped to exactly one business, has no expiry and is shown only once. Send it as Authorization: Bearer <token> together with Accept: application/json.

In: header

Path Parameters

invoice*string

The invoice ID.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Body of POST /invoices and PUT /invoices/{invoice}. On update every field is replaced with what you send; always resend invoice_number or the invoice is renumbered.

type*string

Invoice type. The *vat_invoice types require seller.vat_code and vat_percentage on every line.

Value in

"regular_invoice"
"vat_invoice"
"preliminary_invoice"
"preliminary_vat_invoice"
"credit_invoice"
"credit_vat_invoice"

invoice_date*string

Issue date.

Formatdate

pay_until_date?|

Due date.

Formatdate

series*string

Series code the number belongs to. A new code starts its own counter.

Lengthlength <= 255

notes?|

Free text printed under the lines.

Lengthlength <= 255

currency*string

One of the codes from GET /currencies.

payment_status?|null

language?|

Language of the PDF and the share page. Defaults to lt.

Value in

"en"
"lt"
"es"
"de"
"fr"
null

invoice_number?|

Number within the series; must be unique there. Omit on create to auto-number. On update always resend the current number, otherwise the invoice is renumbered from the series counter. Accepts the padded ("007") or unpadded ("7") form; numbers are compared exactly as sent, so use one form consistently within a series.

Match^(.*)+$

Lengthlength <= 255

buyer*

use_default_seller_info?|

When true the seller block is copied from the business profile (plus the custom fields of the latest invoice) and seller must be omitted.

seller*

Required unless use_default_seller_info is true. Which fields are required depends on the business type: companies send company_name (required) and company_code (optional); individual activities send first_name and last_name (required) and individual_activity_id (optional). Fields of the other kind are rejected.

products*array<>

Invoice lines. Each line carries exactly one of price, total or total_incl_vat.

Items1 <= items

payment_options?array<>|

Payment details printed on the invoice.

Response Body

`application/json`

curl -X PUT "https://example.com/invoices/string" \  -H "Content-Type: application/json" \  -d '{    "type": "vat_invoice",    "invoice_date": "2026-09-12",    "series": "SF",    "currency": "EUR",    "buyer": {      "type": "company"    },    "seller": {},    "products": [      {        "name": "Consulting",        "units": "h",        "quantity": 2      }    ]  }'

{  "data": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "business_id": "f59fcbb7-848d-4242-af07-a8bb7e3ab37c",    "invoice_type": "regular_invoice",    "series": "string",    "invoice_number": "string",    "invoice_date": "2019-08-24",    "pay_until_date": "2019-08-24",    "language": "en",    "subtotal": 0,    "vat": 0,    "total_incl_vat": 0,    "currency": "string",    "payment_status": "not_paid",    "notes": "string",    "share_link": "http://example.com",    "seller": {      "business_type": "small_partnership",      "first_name": "string",      "last_name": "string",      "company_name": "string",      "company_code": "string",      "individual_activity_id": "string",      "vat_code": "string",      "address": "string",      "email": "string",      "phone": "string",      "custom_fields": [        {          "label": "string",          "value": "string"        }      ]    },    "buyer": {      "type": "company",      "first_name": "string",      "last_name": "string",      "company_name": "string",      "company_code": "string",      "individual_activity_id": "string",      "vat_code": "string",      "address": "string",      "email": "string",      "phone": "string"    },    "items": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "name": "string",        "price": 0,        "vat_percentage": 0,        "quantity": 0,        "units": "string"      }    ],    "payment_options": [      {        "type": "bank",        "bank_account": "string",        "bank_name": "string",        "routing_or_sort_number": "string",        "swift_bic_code": "string",        "fields": [          {            "label": "string",            "value": "string"          }        ]      }    ],    "created_at": 0,    "updated_at": 0  }}

Replace an invoice

Authorization

Path Parameters

Request Body

Response Body

200application/json

401application/json

403application/json

404application/json

422application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`