---
title: "Get an order via order number"
method: GET
path: "/v4/orders/{orderNumber}"
tags: ["Orders V4"]
---

# Get an order via order number

`GET /v4/orders/{orderNumber}`

Fetch a single order by its unique order number.

## Path parameters

- `orderNumber` string, required

## Response `200`

Successfully found the requested sales order

- PartnerOrderOrdersV4
  - `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
- `404` — Order with given orderNumber not found

---

[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)