Invoice API 2026-07-14

Endpoints

GET /2026-07-14/invoices/:id/pdf Download PDF

Example request

curl \
  -H "Authorization: Bearer $BUEZLI_API_TOKEN" \
  "https://api.buezli.app/2026-07-14/invoices/123/pdf"

GET /2026-07-14/invoices List records

Example request

curl \
  -H "Authorization: Bearer $BUEZLI_API_TOKEN" \
  "https://api.buezli.app/2026-07-14/invoices?page=1&limit=50"

GET /2026-07-14/invoices/:id Retrieve one record

Example request

curl \
  -H "Authorization: Bearer $BUEZLI_API_TOKEN" \
  "https://api.buezli.app/2026-07-14/invoices/123"

Fields

Field	Type	Description
id	integer	Unique identifier for the resource.
created_at	datetime	Timestamp when the resource was created.
updated_at	datetime	Timestamp when the resource was last updated.
client_id	integer	ID of the client billed by the invoice.
source_estimate_id	integer	ID of the estimate from which the invoice was created.
number	string	Invoice number shown to the customer and unique within the workspace.
status	string	Lifecycle status: draft, sent, late, paid, void or closed.
issue_date	date	Date shown as the invoice issue date.
due_date	date	Date by which the invoice should be paid.
subject	string	Customer-facing subject of the invoice.
notes	string	Customer-facing notes printed on the invoice.
currency	string	ISO 4217 currency code used for invoice amounts.
locale	string	Language code used for customer-facing invoice labels.
recipient_name	string	Customer name preserved on the invoice.
recipient_address	string	Customer address preserved on the invoice.
sender_name	string	Sender name preserved on the invoice.
sender_address	string	Sender address preserved on the invoice.
sender_email	string	Sender email address preserved on the invoice.
sender_phone	string	Sender phone number preserved on the invoice.
sender_vat_number	string	Sender VAT registration number preserved on the invoice.
sender_iban	string	Sender IBAN preserved for invoice payment instructions.
payment_reference	string	Payment reference printed on the invoice and QR bill.
tax_rate	decimal	Default tax percentage inherited by line items without an override.
discount_rate	decimal	Percentage discount applied to the invoice.
subtotal	money	Sum of invoice line items before discounts and taxes.
discount	money	Discount amount deducted from the invoice subtotal.
tax	money	Sum of tax calculated once for each effective tax-rate bucket.
tax_breakdown	array	Taxable amount and tax amount grouped by exact effective tax rate.
total	money	Final invoice total after discounts and taxes.
paid	money	Total amount recorded as paid on the invoice.
due	money	Outstanding invoice amount after recorded payments.
sent_at	datetime	Timestamp when the invoice was marked as sent.
paid_at	datetime	Timestamp when the invoice became fully paid.
voided_at	datetime	Timestamp when the invoice was voided.
void_reason	string	Reason recorded when the invoice was voided.
archived_at	datetime	Timestamp when the invoice was archived, or null when active.
recurring_invoice_template_id	integer	ID of the recurring template that generated the invoice.
recurring_occurrence_on	date	Scheduled occurrence date that produced the recurring invoice.
pdf	download	Availability and API download path for the generated invoice PDF.

Relationships

client

Returned as an ID. Add expand=client to include the related record.

source_estimate

Returned as an ID. Add expand=source_estimate to include the related record.

recurring_invoice_template

Returned as an ID. Add expand=recurring_invoice_template to include the related record.

line_items

Included in every response.

payments

Included in every response.