Developer docsv1
Invoices

Invoices

Webhook event

invoice.created

Sent when a finalized invoice is created, whether through the API, the app or a recurring invoice. The PDF is rendered asynchronously, so it may not exist yet when this event arrives; GET /invoices/{invoice}/download waits up to 20 seconds for it.

POSTHMAC-SHA256 signed2xx within 10 s3 attemptsWebhooks guide

Payload attributes

{ event, data } · 60 attributes

  • eventstring
    Always"invoice.created"
  • dataInvoice
    • idstring (uuid)e.g. "9c1e2d3f-4a5b-4c6d-8e7f-0a1b2c3d4e5f"
    • business_idstring (uuid)e.g. "3f7a1c2e-5b6d-4e8f-9a0b-1c2d3e4f5a6b"
    • invoice_typeInvoiceTypee.g. "vat_invoice"

      The three *vat_invoice types require vat_percentage on every line and, when seller is sent, seller.vat_code.

      One ofregular_invoicevat_invoicepreliminary_invoicepreliminary_vat_invoicecredit_invoicecredit_vat_invoice
    • seriesstringe.g. "PVZ"
    • invoice_numberstringe.g. "012"

      Zero-padded to three digits, e.g. "007". Send it back padded or unpadded on update; both are accepted.

    • invoice_datestring (date)e.g. "2026-03-02"

      Issue date, Y-m-d.

    • pay_until_datestring (date)nullablee.g. "2026-03-16"

      Due date, Y-m-d.

    • languageInvoiceLanguagee.g. "lt"

      Language of the PDF and the public share page.

      One ofenltesdefrpl
    • subtotalnumbere.g. 200

      Sum of the lines excluding VAT.

    • vatnumbere.g. 42
    • total_incl_vatnumbere.g. 242
    • currencystringe.g. "EUR"
    • payment_statusPaymentStatuse.g. "not_paid"
      One ofnot_paidpaid
    • notesstringnullablee.g. "Apmokėti per 14 dienų."
    • share_linkstring (uri)e.g. "https://beta.fsaskaita.lt/invoice/share/7e4a9b2c-3d1f-4a5e-b6c7-d8e9f0a1b2c3"

      Public link to the invoice; anyone with the link can view it.

    • sellerobject
    • buyerobject
    • itemsarray of InvoiceItem
    • payment_optionsarray of PaymentOption
    • created_atintegere.g. 1772435700

      Unix timestamp, seconds.

    • updated_atintegere.g. 1772435700

      Unix timestamp, seconds.

F-sąskaita / DevelopersWhat’s new