Create an invoice

POST/invoices

Creates a finalized invoice and queues its PDF. Fires the invoice.created webhook.

Numbering. Omit invoice_number to take the next number of the series: the series counter, otherwise the highest existing number in that series plus one, otherwise 1. An explicit number must be unique within the series. Numbers are returned zero-padded to three digits.

Amounts. Each product line carries exactly one of price (unit price excluding VAT), total (line total excluding VAT) or total_incl_vat; the other two are derived. vat_percentage is required on the VAT invoice types (vat_invoice, preliminary_vat_invoice, credit_vat_invoice) and whenever the seller has a vat_code; leave it out on non-VAT types.

Seller. Send use_default_seller_info: true to copy the seller block from the business profile (plus the custom fields of the latest invoice); seller is then prohibited. Otherwise send seller with the fields that match the business type: companies use company_name and company_code, individual activities use first_name, last_name and individual_activity_id (company_code and individual_activity_id are optional). VAT invoice types require seller.vat_code when seller is sent; with the default seller info the profile's VAT code is copied as it is.

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

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 POST "https://example.com/invoices" \  -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  }}

Create an invoice

Authorization

Request Body

Response Body

201application/json

401application/json

403application/json

422application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`