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 Uncollected

Defines the status of a billing invoice.

Draft Issued PaymentPending Paid PaymentFailed Cancelled Uncollected

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.

invoiceDatestring

The invoice date (UTC): when it was issued, or an imported invoice's own date. Null on a draft.

The invoice date (UTC): when it was issued, or an imported invoice's own date. Null on a draft.

createdDatestring

When Account Hub created the record (a draft opens when its first line arrives).

When Account Hub created the record (a draft opens when its first line arrives).

sourceApplicationCodestring

The application that raised an imported invoice, which Account Hub only records; null for
Account Hub's own invoices.

The application that raised an imported invoice, which Account Hub only records; null for
Account Hub's own invoices.

accountingInvoiceAccountingLinkResponse

JSON Example

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

Used By Operations