--- title: "Get purchase invoices filtered and paged" slug: "get-purchase-invoices-filtered-and-paged" updated: 2025-11-21T20:01:51Z 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 purchase invoices filtered and paged Post/api/v1/invoices/purchaseinvoices/filter Get a paged list of existing purchase invoices, optionally filtered to the given parameters. **Description** The endpoint retrieves a paged list of existing purchase invoices from the financial accounting administration, filtered to the given parameters. **Use Case** The user may retrieve purchase invoices linked to a specific customer or contract in order to display them within a customer portal or during support interactions, enhancing service quality and transparency. Additionally, the API can be used to identify accounts with a high number of overdue purchase invoices, supporting escalation processes such as legal action or transfer to a collection agency. **Request****fields** The request contains the following fields: | Field | Description | | --- | --- | | pageSize | The maximum number of pages to be returned per request. The default number is 100 and the maximum is 1.000. If more results are returned than specified in the PageSize, the remaining pages are dropped based on the reference (number). | | pageNumber | This allows the requesting party to specify which of the pages they want to receive. | | columnName | The data field based on which sorting is applied. For example, if the results are sorted based on ascending name, columnName will contain the value 'name'. | | order | Based on this value, the property defined in 'columnName' is either sorted ascending (a-z) or descending (z-a). | | reference | The unique identifier of this purchase invoice within Bloxs. This reference is provided by the supplier and is unique per supplier within the client-specific environment. This reference can be used to obtain further information regarding the purchase invoice through the [GET operation](https://www.bloxs.io/v1-api/apidhttps://www.bloxs.io/apidocs/get-a-purchase-invoice). | | ownerReference | The reference of the owner (administration) that is the buying party in this purchase invoice. This is the administration in which the purchase invoice is processed. | | relationReference | The reference of the relation (supplier) that is the selling party in this purchase invoice. It can refer to any relation type within the system and is not necessarily a supplier. For example, another owner invoicing the owner of the purchase invoice. | | invoiceDate.from | The invoice date of the purchase invoice. When used as a filter, only purchase invoices with an invoice date on or after this date are returned. This defines the lower border of the range. | | invoiceDate.to | The invoice date of the purchase invoice. When used as a filter, only purchase invoices with an invoice date on or before this date are returned. This defines the upper border of the range. | | paymentTermName | Description of the payment term, for example: "Payment must be made by [date]." | | dueDate.from | Due date of the purchase invoice. This defines the lower border of the range. | | dueDate.to | Due date of the purchase invoice. This defines the upper border of the range. | | totalAmountExcl.from | The total amount of the purchase invoice, excluding VAT. When applied as a filter, it returns only purchase invoices whose total amount (excluding VAT) is greater than or equal to the specified amount. This defines the lower bound of the filter range. | | totalAmountExcl.to | The total amount of the purchase invoice, excluding VAT. When applied as a filter, it returns only purchase invoices whose total amount (excluding VAT) is less than or equal to the specified amount. This defines the upper bound of the filter range. | | totalAmountVAT.from | The total VAT amount of the purchase invoice. When applied as a filter, it returns only purchase invoices whose total VAT amount is greater than or equal to the specified amount. This defines the lower bound of the filter range. | | totalAmountVAT.to | The total VAT amount of the purchase invoice. When applied as a filter, it returns only purchase invoices whose total VAT amount is less than or equal to the specified amount. This defines the upper bound of the filter range. | | totalAmountIncl.from | The total amount of the purchase invoice, including VAT. When applied as a filter, it returns only purchase invoices whose total amount (including VAT) is greater than or equal to the specified amount. This defines the lower bound of the filter range. | | totalAmountIncl.to | The total amount of the purchase invoice, including VAT. When applied as a filter, it returns only purchase invoices whose total amount (including VAT) is less than or equal to the specified amount. This defines the upper bound of the filter range. | | OutstandingAmount.from | 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. The amount is expressed with two decimals. This defines the lower border of the range. | | OutstandingAmount.to | 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. The amount is expressed with two decimals. This defines the upper border of the range. | | OutstandingAmountReacalculateDate.from | The date on which the outstanding debt was last updated. This value is generated by Bloxs. This defines the lower border of the range. | | OutstandingAmountReacalculateDate.to | The date on which the outstanding debt was last updated. This value is generated by Bloxs. This defines the upper border of the range. | SecurityHTTPType Bearer Please enter a valid token Body parametersExpand Allobject pagingobject (PagingInfo) pageSizeinteger (int32) | null Minimum1Maximum1000 pageNumberinteger (int32) | null Minimum1Maximum9999 sortingobject (SortingInfo) columnNamestring | null orderinteger (int32) Valid values[ 0, 1 ] filterobject (PurchaseInvoiceSearchRequestFilter) referencestring | null ownerReferencestring | null relationReferencestring | null invoiceDateobject (CompareFilterModelDateTime) fromstring (date-time) | null tostring (date-time) | null paymentTermNamestring | null dueDateobject (CompareFilterModelDateTime) fromstring (date-time) | null tostring (date-time) | null totalAmountExclobject (CompareFilterModelDecimal) fromnumber (double) | null tonumber (double) | null totalAmountVATobject (CompareFilterModelDecimal) fromnumber (double) | null tonumber (double) | null totalAmountInclobject (CompareFilterModelDecimal) fromnumber (double) | null tonumber (double) | null outstandingAmountobject (CompareFilterModelDecimal) fromnumber (double) | null tonumber (double) | null outstandingAmountRecalculateDateobject (CompareFilterModelDateTime) fromstring (date-time) | null tostring (date-time) | null Responses200 OK Expand Allobject pagingobject (PagingInfo) pageSizeinteger (int32) | null Minimum1Maximum1000 pageNumberinteger (int32) | null Minimum1Maximum9999 sortingobject (SortingInfo) columnNamestring | null orderinteger (int32) Valid values[ 0, 1 ] purchaseInvoices Array of object (PurchaseInvoiceSearchResultFilter) | null object referencestring | null ownerReferencestring | null relationReferencestring | null invoiceDatestring (date) paymentTermNamestring | null dueDatestring (date) totalAmountExclnumber (double) totalAmountVATnumber (double) totalAmountInclnumber (double) outstandingAmountnumber (double) | null outstandingAmountRecalculateDatestring (date-time) | null