> ## 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 an existing sales invoice. ## OpenAPI ````json GET /api/v1/invoices/salesinvoice { "openapi": "3.0.4", "info": { "title": "Invoices V1", "description": "Welcome to BETA version of the new Invoices API - intended for client public testing before the launch of the final version. During this BETA phase, we'll be improving the API based on specific client's feedbacks.", "version": "v1" }, "security": [ {} ], "tags": [ { "name": "Budgets" }, { "name": "Compactions" }, { "name": "ConceptPurchaseInvoices" }, { "name": "JournalPosts" }, { "name": "Journals" }, { "name": "LedgerAccounts" }, { "name": "Metadata" }, { "name": "PaymentReminders" }, { "name": "PurchaseInvoices" }, { "name": "PurchaseOrders" }, { "name": "SalesInvoices" }, { "name": "SalesInvoiceServices" } ], "paths": { "/api/v1/invoices/salesinvoice": { "get": { "tags": [ "SalesInvoices" ], "summary": "Get a sales invoice", "description": "Get an existing sales invoice.", "operationId": "GetSalesInvoice", "parameters": [ { "name": "reference", "in": "query", "description": "The internal identifier of the model (i.e. Reference, Code, Name, depends on model).", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SalesInvoiceDetail" } } } }, "404": { "description": "The requested sales invoice was not found." } }, "x-d360-narrative-url": "

Get a Sales Invoice

Retrieves the full record of a single existing sales invoice.

A developer calls this endpoint to look up an invoice already sent to a relation and registered in Bloxs, typically to check its amounts, payment status, or links to related records such as a sales contract or sales invoice service.

A sales invoice belongs to a specific owner's financial administration and a specific relation (the customer).

Request Fields

Field

Type

Required

Description

reference

string

Required

The internal identifier of the sales invoice.

Response Fields

Field

Type

Required

Description

reference

string, max 100

Required

The internal identifier (Reference/Code) of the sales invoice.

subject

string, max 512, nullable

Optional

The subject or description line of the invoice.

ownerReference

string, max 100

Required

The internal identifier (Reference/Code) of the owner whose financial administration this invoice belongs to.

relationReference

string, max 100

Required

The internal identifier (Reference/Code) of the relation this invoice was sent to.

invoiceDate

string (date)

Optional

The date on the invoice, formatted as ISO 8601 (YYYY-MM-DD).

paymentTermName

string, max 256

Required

The payment term applied to this invoice.

dueDate

string (date)

Optional

The date by which the invoice is due for payment, formatted as ISO 8601 (YYYY-MM-DD).

totalAmountExcl

number (double)

Optional

The total invoice amount excluding VAT, in the administration's base currency (major units).

totalAmountVAT

number (double)

Optional

The total VAT amount on the invoice, in the administration's base currency (major units).

totalAmountIncl

number (double)

Optional

The total invoice amount including VAT, in the administration's base currency (major units).

outstandingAmount

number (double), nullable

Optional

The amount still outstanding (unpaid) on this invoice, in the administration's base currency (major units).

outstandingAmountRecalculateDate

string (date-time), nullable

Optional

The date and time outstandingAmount was last recalculated, formatted as ISO 8601.

salesContractReference

string, max 100, nullable

Optional

The internal identifier of the sales contract this invoice is linked to, if applicable.

serviceReference

string, nullable

Optional

The internal identifier of the sales invoice service this invoice originated from, if applicable.

lines

array of objects, nullable

Optional

The invoice's line items. See sub-fields below.

lines.lineIndex

integer

Required (within each line)

The position of this line within the invoice.

lines.ledgerAccountCode

string, max 12, nullable

Optional

The general ledger account code this line is booked to.

lines.realEstateObjectReference

string, max 100, nullable

Optional

The internal identifier of the real estate object this line is allocated to, if applicable.

lines.description

string, max 512, nullable

Optional

The description text for this line.

lines.taxRateCode

string, max 100, nullable

Optional

The VAT/tax rate applied to this line, represented as a descriptive label rather than a short code.

lines.amountExcl

number (double), nullable

Optional

The line amount excluding VAT, in the administration's base currency (major units).

lines.amountVAT

number (double), nullable

Optional

The VAT amount for this line, in the administration's base currency (major units).

lines.amountIncl

number (double), nullable

Optional

The line amount including VAT, in the administration's base currency (major units).

" } } }, "components": { "schemas": { "SalesInvoiceDetail": { "required": [ "ownerReference", "paymentTermName", "reference", "relationReference" ], "type": "object", "properties": { "reference": { "maxLength": 100, "minLength": 0, "type": "string" }, "subject": { "maxLength": 512, "minLength": 0, "type": "string", "nullable": true }, "ownerReference": { "maxLength": 100, "minLength": 0, "type": "string" }, "relationReference": { "maxLength": 100, "minLength": 0, "type": "string" }, "invoiceDate": { "type": "string", "format": "date" }, "paymentTermName": { "maxLength": 256, "minLength": 0, "type": "string" }, "dueDate": { "type": "string", "format": "date" }, "totalAmountExcl": { "type": "number", "format": "double" }, "totalAmountVAT": { "type": "number", "format": "double" }, "totalAmountIncl": { "type": "number", "format": "double" }, "outstandingAmount": { "type": "number", "format": "double", "nullable": true }, "outstandingAmountRecalculateDate": { "type": "string", "format": "date-time", "nullable": true }, "salesContractReference": { "maxLength": 100, "minLength": 0, "type": "string", "nullable": true }, "serviceReference": { "type": "string", "nullable": true }, "lines": { "type": "array", "items": { "$ref": "#/components/schemas/SalesInvoiceLineAPIModel" }, "nullable": true } }, "additionalProperties": false }, "SalesInvoiceLineAPIModel": { "type": "object", "properties": { "lineIndex": { "type": "integer", "format": "int32" }, "ledgerAccountCode": { "maxLength": 12, "minLength": 0, "type": "string", "nullable": true }, "realEstateObjectReference": { "maxLength": 100, "minLength": 0, "type": "string", "nullable": true }, "description": { "maxLength": 512, "minLength": 0, "type": "string", "nullable": true }, "taxRateCode": { "maxLength": 100, "minLength": 0, "type": "string", "nullable": true }, "amountExcl": { "type": "number", "format": "double" }, "amountVAT": { "type": "number", "format": "double" }, "amountIncl": { "type": "number", "format": "double" } }, "additionalProperties": false } } } } ````