---
title: "List of orders filtered by fulfillment state"
method: GET
path: "/v4/orders"
tags: ["Orders V4"]
---

# List of orders filtered by fulfillment state

`GET /v4/orders`

Retrieve orders sorted by order date from oldest to newest. The number of returned orders is limited to 128; cursor based pagination is supported.

## Query parameters

- `fromDate` string
- `fromOrderDate` string
- `toOrderDate` string
- `fulfillmentStatus` 'ANNOUNCED' | 'PROCESSABLE' | 'SENT' | 'RETURNED' | 'CANCELLED_BY_PARTNER' | 'CANCELLED_BY_MARKETPLACE'
- `limit` string
- `orderDirection` string
- `orderColumnType` string
- `mode` string
- `nextcursor` string

## Response `200`

Successfully retrieved sales orders

- PartnerOrderListOrdersV4
  - `links` LinkOrdersV4[] — Links related to the list. E.g. the link to the successive list used during paging.
    - `href` string — The url of the link
    - `rel` string — The relation type of the link. See also https://www.iana.org/assignments/link-relations/link-relations.xhtml. The relation type 'next' is used for paging. The relation type 'self' refers to the url of the resource
  - `resources` PartnerOrderOrdersV4[] — The list of queried resources. In this case partner orders.
    - `deliveryAddress` AddressOrdersV4 — Address
      - `addition` string — The addition
      - `city` string, required — The city
      - `countryCode` string, required — The country in ISO-3166-1 Alpha-3 format
      - `email` string — The e-mail address; if part of the delivery address is in plain text; if part of the invoice address it's a pseudonymized e-mail address
      - `firstName` string, required — The firstName
      - `houseNumber` string, required — The house number
      - `lastName` string, required — The lastName
      - `phoneNumber` string — The phone number
      - `salutation` string, required — The salutation (MR, MS, COMPANY, UNKNOWN)
      - `street` string, required — The street
      - `zipCode` string, required — The zipCode
    - `initialDeliveryFees` InitialDeliveryFeeOrdersV4[] — The delivery fees on customer checkout
      - `deliveryFeeAmount` AmountOrdersV4, required — Amount
        - `amount` number, required — The amount
        - `currency` string, required — The currency in ISO_4217 format
      - `name` string, required — The type of this delivery fee
      - `positionItemIds` string[], required — The position item ids to which this delivery fee applies
      - `vatRate` number, required — The highest VAT rate of the products of all the position items
    - `initialDiscounts` InitialDiscountOrdersV4[] — The initial discounts on customer checkout
      - `discountAmount` AmountOrdersV4, required — Amount
        - `amount` number, required — The amount
        - `currency` string, required — The currency in ISO_4217 format
      - `discountId` string, required — The id of this discount
      - `discountName` string, required — The name of this discount
      - `name` string, required — The type of this discount
      - `positionItemIds` string[], required — The position item ids to which this discount applies
      - `vatRate` number, required — The highest VAT rate between discounted products
    - `invoiceAddress` AddressOrdersV4 — Address
      - `addition` string — The addition
      - `city` string, required — The city
      - `countryCode` string, required — The country in ISO-3166-1 Alpha-3 format
      - `email` string — The e-mail address; if part of the delivery address is in plain text; if part of the invoice address it's a pseudonymized e-mail address
      - `firstName` string, required — The firstName
      - `houseNumber` string, required — The house number
      - `lastName` string, required — The lastName
      - `phoneNumber` string — The phone number
      - `salutation` string, required — The salutation (MR, MS, COMPANY, UNKNOWN)
      - `street` string, required — The street
      - `zipCode` string, required — The zipCode
    - `lastModifiedDate` string, date-time — Last order update date
    - `links` LinkOrdersV4[] — Order related links like the link to fetch the single partner order
      - `href` string — The url of the link
      - `rel` string — The relation type of the link. See also https://www.iana.org/assignments/link-relations/link-relations.xhtml. The relation type 'next' is used for paging. The relation type 'self' refers to the url of the resource
    - `orderDate` string, date-time, required — The date, when this order has been placed
    - `orderLifecycleInformation` OrderLifecycleInformationOrdersV4, required — OrderLifecycleInformation
      - `lifecycleChangeDate` string, date-time, required — The date, when this order has been placed
    - `orderNumber` string, required — The order number. An unique human readable 10 character(alphanumeric) identifier referring to this order
    - `payment` PaymentOrdersV4 — Payment
      - `paymentMethod` string, required — The payment method. Values currently in use are "INVOICE_SINGLE", "INVOICE_INSTALLMENTS", "PREPAYMENT", "DIRECT_DEBIT", "DIRECT_DEBIT_INSTALLMENTS", "CREDIT_CARD_ONLINE" (DEPRECATED), "PAYPAL", "CREDIT_CARD". These values are subject to change.
    - `positionItems` PositionItemOrdersV4[], required — The physical position items of this order. Multiple position item can refer to the same product
      - `cancellationDate` string, date-time — Date the position item was cancelled
      - `cancellationReason` 'CANCELLED_ON_CUSTOMER_WISH' | 'CANCELLED_ON_PARTNER_WISH' | 'PAYMENT_ABORTED' | 'PAYMENT_FRAUD' | 'PARTNER_TERMINATED' | 'ILLEGAL_PRODUCT' | 'MARKETPLACE_FRAUD' | 'CANCELLED_ON_MARKETPLACE_WISH' — Reason why a position was cancelled
      - `dealId` string — The unique id of the deal related to the position item
      - `dealName` string — The name of the deal related to the position item
      - `expectedDeliveryDate` string, date-time — The date the position item should be delivered
      - `fulfillmentStatus` 'ANNOUNCED' | 'PROCESSABLE' | 'SENT' | 'RETURNED' | 'CANCELLED_BY_PARTNER' | 'CANCELLED_BY_MARKETPLACE', required — The fulfillment status of the position item
      - `itemValueDiscount` AmountOrdersV4 — Amount
        - `amount` number, required — The amount
        - `currency` string, required — The currency in ISO_4217 format
      - `itemValueGrossPrice` AmountOrdersV4, required — Amount
        - `amount` number, required — The amount
        - `currency` string, required — The currency in ISO_4217 format
      - `itemValueReducedGrossPrice` AmountOrdersV4 — Amount
        - `amount` number, required — The amount
        - `currency` string, required — The currency in ISO_4217 format
      - `positionItemId` string, required — The unique id of the position item
      - `processableDate` string, date-time — Date the position item has reached PROCESSABLE fulfillment status
      - `product` ProductOrdersV4, required — Product
        - `articleNumber` string, required — The external identifier of the product, it is shown as "article number" on the product detail page of otto.de to the customer.
        - `dimensions` DimensionOrdersV4[] — List of dimensions that are individual for each product type
          - `displayName` string — The type description written out for displaying purposes
          - `type` string — The standardized type description
          - `value` string — The actual value of the dimension
        - `ean` string — EAN number of this product
        - `productTitle` string, required — The title of this product
        - `shopUrl` string — Shop link for the product
        - `sku` string, required — The external identifier of the variation, uniquely identifies a variation in partner cataloq
        - `vatRate` number, required — The VAT rate for ordered products and shipping costs
      - `returnAcceptedByMarketplace` boolean — Flag to indicate that the return has been accepted by the marketplace
      - `returnedDate` string, date-time — Date the position item was returned
      - `sentDate` string, date-time — Date the position item was sent
      - `trackingInfo` TrackingInfoOrdersV4 — TrackingInfo
        - `carrier` string — The name of the carrier
        - `carrierServiceCode` string — The service code provided by the carrier
        - `trackingNumber` string — The tracking number provided by the carrier
      - `weeePickup` boolean — Position item has electrical and electronic equipment disposal service (WEEE)
    - `salesOrderId` string, required — The id of the corresponding sales order. For one partner the sales order id is unique
    - `suspectedFraudCase` boolean — Order is suspected fraud case or not

## Other responses

- `400` — Request is invalid
- `401` — Authentication failed
- `403` — Forbidden

---

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