API Docs / Schemas / InvoiceResponse

InvoiceResponse

Response model representing an invoice with its line items.

Properties

Name Type Description
code*string

The unique code identifier for the invoice.

The unique code identifier for the invoice.

invoiceNumber*string

The customer-facing invoice number (e.g., "INV-000001").

The customer-facing invoice number (e.g., "INV-000001").

companyName*string

The company name of the invoice issuer.

The company name of the invoice issuer.

vatNumber*string

The VAT registration number of the invoice issuer.

The VAT registration number of the invoice issuer.

statusenum

Defines the status of a billing invoice.

Draft Issued PaymentPending Paid PaymentFailed Cancelled

Defines the status of a billing invoice.

Draft Issued PaymentPending Paid PaymentFailed Cancelled

subtotalAmountnumber

The subtotal amount (sum of line items net amounts) before VAT, in pounds.

The subtotal amount (sum of line items net amounts) before VAT, in pounds.

vatAmountnumber

The total VAT amount (sum of line item VAT amounts) in pounds.

The total VAT amount (sum of line item VAT amounts) in pounds.

totalAmountnumber

The total amount of the invoice (subtotal + VAT) in pounds.

The total amount of the invoice (subtotal + VAT) in pounds.

dueDatestring

The date when payment is due.

The date when payment is due.

paidDatestring

The date and time when payment was received.

The date and time when payment was received.

failureReasonstring

The reason for payment failure, if applicable.

The reason for payment failure, if applicable.

pdfBlobUrlstring

Time-limited URL for downloading the invoice PDF. Null if PDF has not been generated.

Time-limited URL for downloading the invoice PDF. Null if PDF has not been generated.

lineItemsarray of InvoiceLineItemResponse

The line items included in this invoice.

The line items included in this invoice.

createdDatestring

The date and time when the invoice was created.

The date and time when the invoice was created.

JSON Example

{
  "code": "string",
  "invoiceNumber": "string",
  "companyName": "string",
  "vatNumber": "string",
  "status": "Draft"
}

Used By Operations