--- title: "Get a sales invoice" slug: "preview-get-a-sales-invoice" updated: 2025-06-20T08:12:32Z published: 2026-02-10T12:53:32Z --- > ## Documentation Index > Fetch the complete documentation index at: https://www.bloxs.io/llms.txt > Use this file to discover all available pages before exploring further. # Get a sales invoice Get/api/v1/invoices/salesinvoice Get an existing sales invoice. **Description** This endpoint retrieves sales invoices related to a specific real estate object. **Use Case** The user wants to retrieve an individual sales invoice by specifying its reference. To obtain the reference of a particular invoice, the user can first use the [POST filter](/v1-api/apidocs/preview-get-sales-invoices-filtered-and-paged) endpoint. Currently, this GET API returns the same information as the filter API. However, this will change in the future: additional fields will be added to the GET operation, enabling it to provide more detailed information than the filter API. **Request****fields** The request contains the following fields: | Field | Description | | --- | --- | | reference | The unique identifier for this sales invoice within Bloxs. This is unique (per client specific environment) for all sales invoices. This identifier is generated by the Bloxs system. | **Response fields** The 200 response contains the fields in the table below. For the GET operation it gives a up-to-date insight in the data that is currently registered in Bloxs. | Field | Description | | --- | --- | | reference | The unique identifier for this sales invoice within Bloxs. This is unique (per client specific environment) for all sales invoices. This identifier is generated by the Bloxs system. | | subject | Invoice subject. | | ownerReference | This is the reference of the owner of the object. | | relationReference | This is the reference of the relation associated with the reminder. It can refer to any relation type within the system and is not necessarily a tenant. For example, it may also refer to an owner who has an outstanding debt with another owner. | | invoiceDate | Invoice date. | | paymentTermName | Description of the payment term, for example: "Payment must be made by [date]." | | dueDate | Due date of the invoice. | | totalAmountExcl | Total amount excluding VAT. | | totalAmountVAT | Total VAT amount. | | totalAmountIncl | Total amount including VAT. | | outstandingAmount | Total outstanding amount for the current month only. This reflects the amount due specifically within the current month and does not include any outstanding balances from previous months. | | outstandingAmountRecalcaulateDate | The date on which the outstanding debt was last updated. This value is generated by Bloxs. | SecurityHTTPType Bearer Please enter a valid token Query parametersreferencestringRequired The internal identifier of the model (i.e. Reference, Code, Name, depends on model). Responses200 OK object referencestring Min length0Max length100 subjectstring | null Min length0Max length512 ownerReferencestring Min length0Max length100 relationReferencestring Min length0Max length100 invoiceDatestring (date) paymentTermNamestring Min length0Max length256 dueDatestring (date) totalAmountExclnumber (double) totalAmountVATnumber (double) totalAmountInclnumber (double) outstandingAmountnumber (double) | null outstandingAmountRecalculateDatestring (date-time) | null 404 The requested sales invoice was not found.