---
title: "GetOpenOrders"
method: POST
path: "/api/OpenOrders/GetOpenOrders"
tags: ["OpenOrders"]
---

# GetOpenOrders

`POST /api/OpenOrders/GetOpenOrders`

<b>Rate limit: </b><span style="background-color:#0272d9;color:white;padding:4px 8px;text-align:center;border-radius:5px; font-size: small;"><b>150</b></span> / minute

## Request body

- GetOpenOrdersRequest
  - `ViewId` integer, required
  - `LocationId` string, uuid, required
  - `EntriesPerPage` integer, required
  - `PageNumber` integer
  - `OrderIds` string[]

## Response `200`

OK

- PostFilterPagedResponseOpenOrder
  - `ResultCountRemovedByPostFilter` integer
  - `PageNumber` integer — Result page number
  - `EntriesPerPage` integer — Result page size, quantity of records per page
  - `TotalEntries` integer — Total records
  - `TotalPages` integer — Total pages
  - `Data` OpenOrder[]
    - `NumOrderId` integer — Linnworks order number
    - `GeneralInfo` OrderGeneralInfo — BasicOrderGeneralInfo
      - `Status` integer — Order Status (0 = UNPAID, 1 = PAID, 2 = RETURN, 3 = PENDING, 4 = RESEND)
      - `StatusDescription` string, nullable — Description of the order status
      - `LabelPrinted` boolean — Is label printed?
      - `LabelError` string, nullable — Is there a label error?
      - `InvoicePrinted` boolean — Is invoice printed?
      - `InvoicePrintError` string, nullable — Is there a invoice print error?
      - `PickListPrinted` boolean — Is pick list printed?
      - `PickListPrintError` string, nullable — Is there a pick list print error?
      - `NotesCount` integer — Quantity of order notes
      - `Marker` integer — Order marker (0 = NOT TAG, 1 = Tag 1, 2 = Tag 2, 3 = Tag 3, 4 = Tag 4, 5 = Tag 5, 6 = Tag 6, 7 = Parked)
      - `Identifiers` BasicIdentifier[], nullable — Order identifiers. [Prime | Scheduled]
        - `Tag` string, nullable — Internal tag for identification purposes
        - `Name` string, nullable — Display name for the identifier
      - `ReferenceNum` string, nullable — Order reference number (Channel defined)
      - `SecondaryReference` string, nullable — An additional reference number for the order (Used by some channels)
      - `ExternalReferenceNum` string, nullable — This is an additional reference number from the sales channel, typically used by eBay
      - `ReceivedDate` string, date-time — The date and time at which the order was placed on the sales channel
      - `Source` string, nullable — Order ChannelName/Source (e.g. EBAY)
      - `SubSource` string, nullable — Order SubSource (e.g. EBAY1)
      - `DespatchByDate` string, date-time — Despatch by Date
      - `ScheduledDelivery` ScheduledDelivery — ScheduledDelivery
        - `From` string, date-time, nullable — The start of requested delivery
        - `To` string, date-time, nullable — The end of requested delivery
      - `HasScheduledDelivery` boolean — Does the order have scheduled delivery dates?
      - `NumItems` integer — Quantity of order items
      - `StockAllocationType` 'NotAllocated' | 'Insuffient' | 'Partial' | 'Full' | 'OverAllocated' — StockAllocationType
    - `ShippingInfo` OrderShippingInfo — OrderShippingInfo
      - `Vendor` string, nullable — Courier name (e.g. Royal Mail)
      - `PostalServiceId` string, uuid — Postal service ID
      - `PostalServiceName` string, nullable — Postal service name (e.g. Next day delivery)
      - `TotalWeight` number, double — Order total weight
      - `ItemWeight` number, double — Order item weight
      - `PackageCategoryId` string, uuid — Package category ID
      - `PackageCategory` string, nullable — Package category name
      - `PackageTypeId` string, uuid, nullable — Package type ID
      - `PackageType` string, nullable — Package type name
      - `TrackingNumber` string, nullable — Order tracking number provided by courier
      - `ManualAdjust` boolean — If there is an adjustment to shipping cost was made
    - `CustomerInfo` OrderCustomerInfo — OrderCustomerInfo
      - `ChannelBuyerName` string, nullable — Username of customer (Comes from channel)
      - `Address` ShippingAddress — BillingAddress
        - `Address1` string, nullable — First line of customer address.
        - `Address2` string, nullable — Second line of customer address.
        - `Address3` string, nullable — Third line of customer address.
        - `Town` string, nullable — Customer's town.
        - `Region` string, nullable — Customer's region.
        - `PostCode` string, nullable — Customer's postcode.
        - `Country` string, nullable — Customer's country.
        - `CountryId` string, uuid — Customer's country id.
        - `FullName` string, nullable — Customer's first and second name.
        - `Company` string, nullable — Customer's company name.
        - `PhoneNumber` string, nullable — Customer's telephone number.
        - `EmailAddress` string, nullable — Customer's email address.
      - `BillingAddress` union — Customer billing address
        - BillingAddress — BillingAddress
          - `Address1` string, nullable — First line of customer address.
          - `Address2` string, nullable — Second line of customer address.
          - `Address3` string, nullable — Third line of customer address.
          - `Town` string, nullable — Customer's town.
          - `Region` string, nullable — Customer's region.
          - `PostCode` string, nullable — Customer's postcode.
          - `Country` string, nullable — Customer's country.
          - `CountryId` string, uuid — Customer's country id.
          - `FullName` string, nullable — Customer's first and second name.
          - `Company` string, nullable — Customer's company name.
          - `PhoneNumber` string, nullable — Customer's telephone number.
          - `EmailAddress` string, nullable — Customer's email address.
        - ShippingAddress — BillingAddress
          - `Address1` string, nullable — First line of customer address.
          - `Address2` string, nullable — Second line of customer address.
          - `Address3` string, nullable — Third line of customer address.
          - `Town` string, nullable — Customer's town.
          - `Region` string, nullable — Customer's region.
          - `PostCode` string, nullable — Customer's postcode.
          - `Country` string, nullable — Customer's country.
          - `CountryId` string, uuid — Customer's country id.
          - `FullName` string, nullable — Customer's first and second name.
          - `Company` string, nullable — Customer's company name.
          - `PhoneNumber` string, nullable — Customer's telephone number.
          - `EmailAddress` string, nullable — Customer's email address.
      - `TaxId` string, nullable — Buyer's tax number.
    - `TotalsInfo` OrderTotalsInfo — OrderTotalsInfo
      - `Subtotal` number, double — Order subtotal
      - `PostageCost` number, double — Order postage cost
      - `PostageCostExTax` number, double — Order postage cost ex. tax
      - `Tax` number, double — Tax
      - `TotalCharge` number, double — Total charge
      - `PaymentMethod` string, nullable — Payment method
      - `PaymentMethodId` string, uuid — Payment method ID
      - `TotalDiscount` number, double — Total discount applied to the order
      - `Currency` string, nullable — Order currency
      - `CountryTaxRate` number, double — Country tax rate
      - `ConversionRate` number, double — Currency conversion rate. Set at point of save by the currency
    - `TaxInfo` OrderTaxInfo
      - `TaxNumber` string — Customer Tax Number
    - `FolderName` string[] — Folder name of an order if any assigned
    - `IsPostFilteredOut` boolean
    - `CanFulfil` boolean
    - `Fulfillment` OrderFulfillmentState
      - `FulfillmentState` 'Unknown' | 'Insufficient_Stock' | 'Insufficient_To_Fulfill_All' | 'Sufficient_Stock'
      - `PurchaseOrderState` 'Insufficient_PO' | 'Sufficient_PO'
    - `Items` OrderItem[]
      - `RowId` string, uuid — Record row ID
      - `StockItemId` string, uuid — Stock Item ID
      - `IsService` boolean — Is the item a service?
      - `IsUnlinked` boolean — Is the item unlinked?
      - `Quantity` integer — Quantity
    - `HasItems` boolean
    - `TotalItemsSum` integer
    - `OrderId` string, uuid — Order ID (pkOrderID)

---

[API](https://skmtc.net/linnworks/apis/authenticate-api.md) · [All operations](https://skmtc.net/linnworks/apis/authenticate-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/linnworks/authenticate-api/versions/0123569a22fb/schema)
