> ## 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 sales invoices service filtered and paged > Get a paged list of existing sales invoice services, optionally filtered to the given parameters. ## OpenAPI ````json POST /api/v1/invoices/salesinvoiceservices/filter { "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/salesinvoiceservices/filter": { "post": { "tags": [ "SalesInvoiceServices" ], "summary": "Get sales invoices service filtered and paged", "description": "Get a paged list of existing sales invoice services, optionally filtered to the given parameters.", "operationId": "GetSalesInvoiceServicesFilteredPaged", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SalesInvoiceServiceSearchRequest" } } } }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SalesInvoiceServiceSearchResult" } } } } }, "x-d360-narrative-url": "

Get Sales Invoice Services Filtered and Paged (POST)

Retrieves a paged, optionally filtered list of existing sales invoice services.

A developer calls this endpoint to search for sales invoice services matching one or more criteria (for example by owner, relation, supply date, or payment method), or to retrieve the full set of sales invoice services in manageable pages when no filter is needed.

Request Fields

Field

Type

Required

Description

paging.pageSize

integer, 1 to 1000, nullable

Optional

The number of sales invoice services to return per page. Defaults to 100 when not given.

paging.pageNumber

integer, 1 to 9999, nullable

Optional

The page number to retrieve. Defaults to 1 when not given.

sorting.columnName

string, nullable

Optional

The name of the field to sort the results by.

sorting.order

integer (enum), nullable

Optional

The sort direction. Allowed values: 0 = Ascending, 1 = Descending.

filter.reference

string, nullable

Optional

Filters on the sales invoice service's internal identifier (Reference/Code).

filter.ownerReference

string, nullable

Optional

Filters on the owner whose financial administration the service belongs to.

filter.relationReference

string, nullable

Optional

Filters on the relation (customer) the service is delivered to.

filter.supplyDate.from

string (date-time), nullable

Optional

Inclusive lower bound for filtering on supply date, formatted as ISO 8601. If omitted, there is no lower bound.

filter.supplyDate.to

string (date-time), nullable

Optional

Inclusive upper bound for filtering on supply date, formatted as ISO 8601. If omitted, there is no upper bound.

filter.paymentMethod

integer (enum), nullable

Optional

Filters on the payment method. Allowed values: 1 = DirectDebit, 2 = BankTransfer.

filter.totalAmountExcl.from

number (double), nullable

Optional

Inclusive lower bound for filtering on the total amount excluding VAT. If omitted, there is no lower bound.

filter.totalAmountExcl.to

number (double), nullable

Optional

Inclusive upper bound for filtering on the total amount excluding VAT. If omitted, there is no upper bound.

filter.totalAmountVAT.from

number (double), nullable

Optional

Inclusive lower bound for filtering on the total VAT amount. If omitted, there is no lower bound.

filter.totalAmountVAT.to

number (double), nullable

Optional

Inclusive upper bound for filtering on the total VAT amount. If omitted, there is no upper bound.

filter.totalAmountIncl.from

number (double), nullable

Optional

Inclusive lower bound for filtering on the total amount including VAT. If omitted, there is no lower bound.

filter.totalAmountIncl.to

number (double), nullable

Optional

Inclusive upper bound for filtering on the total amount including VAT. If omitted, there is no upper bound.

Response Fields

Field

Type

Required

Description

paging.pageSize

integer, 1 to 1000, nullable

Optional

The page size used to produce this result set.

paging.pageNumber

integer, 1 to 9999, nullable

Optional

The page number returned in this result set.

sorting.columnName

string, nullable

Optional

The field the results are sorted by.

sorting.order

integer (enum), nullable

Optional

The sort direction applied. Allowed values: 0 = Ascending, 1 = Descending.

salesInvoiceServices

array of objects, nullable

Optional

The list of sales invoice services matching the filter for this page. See sub-fields below.

salesInvoiceServices.reference

string, nullable

Optional

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

salesInvoiceServices.externalIdentifier

string, nullable

Optional

The external API identifier of the sales invoice service, if any.

salesInvoiceServices.salesContractReference

string, nullable

Optional

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

salesInvoiceServices.ownerReference

string, nullable

Optional

The internal identifier of the owner whose financial administration this service belongs to.

salesInvoiceServices.relationReference

string, nullable

Optional

The internal identifier of the relation (customer) this service is delivered to.

salesInvoiceServices.supplyDate

string (date)

Optional

The date the service was supplied, formatted as ISO 8601 (YYYY-MM-DD).

salesInvoiceServices.workflowState

integer (enum)

Optional

The approval workflow state of this sales invoice service. Allowed values: 1 = Draft, 2 = OnHold, 3 = Cancelled, 4 = ApprovalWorkflow, 7 = Final, 9 = Disapproved, 10 = OwnerApprovalWorkflow, 11 = DisapprovedByOwner.

" } } }, "components": { "schemas": { "SalesInvoiceServiceSearchRequest": { "type": "object", "properties": { "paging": { "$ref": "#/components/schemas/PagingInfo" }, "sorting": { "$ref": "#/components/schemas/SortingInfo" }, "filter": { "$ref": "#/components/schemas/SalesInvoiceServiceSearchRequestFilter" } }, "additionalProperties": false }, "SalesInvoiceServiceSearchResult": { "type": "object", "properties": { "paging": { "$ref": "#/components/schemas/PagingInfo" }, "sorting": { "$ref": "#/components/schemas/SortingInfo" }, "salesInvoiceServices": { "type": "array", "items": { "$ref": "#/components/schemas/SalesInvoiceServiceSearchResultFilter" }, "nullable": true } }, "additionalProperties": false }, "PagingInfo": { "type": "object", "properties": { "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "format": "int32", "nullable": true }, "pageNumber": { "maximum": 9999, "minimum": 1, "type": "integer", "format": "int32", "nullable": true } }, "additionalProperties": false }, "SortingInfo": { "type": "object", "properties": { "columnName": { "type": "string", "nullable": true }, "order": { "type": "integer", "description": "Ascending = 0\nDescending = 1", "format": "int32", "x-enumNames": [ "Ascending", "Descending" ] } }, "additionalProperties": false }, "SalesInvoiceServiceSearchRequestFilter": { "type": "object", "properties": { "reference": { "type": "string", "nullable": true }, "ownerReference": { "type": "string", "nullable": true }, "relationReference": { "type": "string", "nullable": true }, "supplyDate": { "$ref": "#/components/schemas/CompareFilterModelDateTime" }, "paymentMethod": { "type": "integer", "description": "DirectDebit = 1\nBankTransfer = 2\nWithdrawal = 3\nCash = 4\niDEAL = 5", "format": "int32", "nullable": true, "x-enumNames": [ "DirectDebit", "BankTransfer", "Withdrawal", "Cash", "iDEAL" ] }, "totalAmountExcl": { "$ref": "#/components/schemas/CompareFilterModelDecimal" }, "totalAmountVAT": { "$ref": "#/components/schemas/CompareFilterModelDecimal" }, "totalAmountIncl": { "$ref": "#/components/schemas/CompareFilterModelDecimal" } }, "additionalProperties": false }, "SalesInvoiceServiceSearchResultFilter": { "type": "object", "properties": { "reference": { "type": "string", "nullable": true }, "externalIdentifier": { "type": "string", "nullable": true }, "salesContractReference": { "type": "string", "nullable": true }, "ownerReference": { "type": "string", "nullable": true }, "relationReference": { "type": "string", "nullable": true }, "supplyDate": { "type": "string", "format": "date" }, "workflowState": { "type": "integer", "description": "Draft = 1\nOnHold = 2\nCancelled = 3\nApprovalWorkflow = 4\nFinal = 7\nDisapproved = 9\nOwnerApprovalWorkflow = 10\nDisapprovedByOwner = 11", "format": "int32", "x-enumNames": [ "Draft", "OnHold", "Cancelled", "ApprovalWorkflow", "Final", "Disapproved", "OwnerApprovalWorkflow", "DisapprovedByOwner" ] } }, "additionalProperties": false }, "CompareFilterModelDateTime": { "type": "object", "properties": { "from": { "type": "string", "format": "date-time", "nullable": true }, "to": { "type": "string", "format": "date-time", "nullable": true } }, "additionalProperties": false }, "CompareFilterModelDecimal": { "type": "object", "properties": { "from": { "type": "number", "format": "double", "nullable": true }, "to": { "type": "number", "format": "double", "nullable": true } }, "additionalProperties": false } } } } ````