Skip to main content

Get invoice by ID

GET 
/invoices/{invoiceId}

Returns detailed data for a specific invoice identified by invoiceId.

Audit event:

  • invoice.get

Privilege (one of):

  • finance-invoices.view
  • finance-invoices-own.view

Key Behaviors:

Extended Data

  • Returns full invoice details including items, extent, files, and billing balance info
  • For CREDIT_DEBIT_NOTE and SUPPLIER_CR_DB_NOTE, includes comment field extracted from first active item
  • For PREPAID and POSTPAID (PART-PAYMENT), includes billingBalance with credit record info
  • For POSTPAID (non-PART-PAYMENT), includes billingBalance with billing record info and smsCount
  • For POSTPAID-CONTROL, includes billingBalance, billingTypeName, and smsCount

Errors:

  • NOT_AUTHORIZED - Not authorized
  • NOT_AUTHENTICATED - Not authenticated
  • INVOICE_NOTFOUND - Invoice not found
  • INT_APP_ERROR - Unexpected internal error

Request​

Responses​

Invoice data with extended details