---
title: "Get a list of all invoices optionally filtered by date. This request ist throttled to 1 per 1 minute for same page and minInvoiceDate"
method: GET
path: "/api/v1/orders/invoices"
tags: ["Orders", "Invoice"]
---

# Get a list of all invoices optionally filtered by date. This request ist throttled to 1 per 1 minute for same page and minInvoiceDate

`GET /api/v1/orders/invoices`

## Query parameters

- `minInvoiceDate` string, date-time
- `maxInvoiceDate` string, date-time
- `page` integer
- `pageSize` integer
- `shopId` integer[]
- `orderStateId` integer[]
- `tag` string[]
- `minPayDate` string, date-time
- `maxPayDate` string, date-time
- `includePositions` boolean
- `excludeTags` boolean
- `excludeArchivedOrders` boolean

## Response `200`

OK

- RechnungsdruckWebAppControllersApiApiPagedResultOfSystemCollectionsGenericListOfBillbeeInterfacesBillbeeAPIModelInvoiceApiModel
  - `Paging` RechnungsdruckWebAppControllersApiApiPagedResultPagingInformationOfSystemCollectionsGenericListOfBillbeeInterfacesBillbeeAPIModelInvoiceApiModel
    - `Page` integer
    - `TotalPages` integer
    - `TotalRows` integer
    - `PageSize` integer
  - `ErrorMessage` string
  - `ErrorCode` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31
  - `ErrorDescription` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31
  - `Data` BillbeeInterfacesBillbeeAPIModelInvoiceApiModel[]
    - `InvoiceNumber` string
    - `Type` string
    - `Title` string
    - `Salutation` string
    - `LastName` string
    - `FirstName` string
    - `Company` string
    - `CustomerNumber` integer
    - `DebtorNumber` integer
    - `InvoiceDate` string, date-time
    - `TotalNet` number, double
    - `Currency` string
    - `TotalGross` number, double
    - `PaymentTypeId` integer
    - `OrderNumber` string
    - `TransactionId` string
    - `Email` string
    - `ShopName` string
    - `Positions` BillbeeInterfacesBillbeeAPIModelInvoiceApiPositionApiModel[]
      - `Position` integer
      - `Amount` number, double
      - `NetValue` number, double
      - `TotalNetValue` number, double
      - `GrossValue` number, double
      - `TotalGrossValue` number, double
      - `VatRate` number, double
      - `ArticleBillbeeId` integer
      - `Sku` string
      - `Title` string
      - `BillbeeId` integer
      - `TotalVatAmount` number, double
      - `RebatePercent` number, double
    - `PayDate` string, date-time
    - `VatMode` 0 | 1 | 2 | 3 | 4 | 5
    - `BillbeeId` integer
    - `ShippingCountry` string — two letters for CountryCode Identification
    - `AdditionalFees` BillbeeInterfacesBillbeeAPIModelAdditionalFeeApiModel[]
      - `Type` string
      - `Gross` number, double
      - `Net` number, double
      - `VatAmount` number, double
      - `VatRate` number, double
    - `MerchantVatId` string — The vat-id, that should be displayed on the invoice and other order documents
    - `CustomerVatId` string — The vat-id, that was given by the customer to fulfill this order
    - `VatFlags` BillbeeInterfacesOrderVatDetailsRecognizedHistoryEntryVatDetectionFlags
      - `ThirdPartyCountry` boolean
      - `SrcCountryIsEqualToDstCountry` boolean
      - `CustomerHasVatId` boolean
      - `EuDeliveryThresholdExceeded` boolean
      - `OssEnabled` boolean
      - `SellerIsRegisteredInDstCountry` boolean
      - `OrderDistributionCountryIsEmpty` boolean
      - `UserProfileCountryIsEmpty` boolean
      - `SetIglWhenVatIdIsAvailableEnabled` boolean
      - `RatesFrom` string
      - `VatIdFrom` string
      - `IsDistanceSale` boolean

---

[API](https://skmtc.dev/billbee/apis/billbee-api.md) · [All operations](https://skmtc.dev/billbee/apis/billbee-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/billbee/billbee-api/revisions/e64f07f4f526/schema)