OTotto
Products V5

Read marketplace status of product variations

Changed on

The total number of results could be limited by specifying query parameters. Generally the resulting marketplace status will be paginated. The default page length is 100 product variations per response, also the page size limit. The links specified in the result can be used to page through the total result space.

get/v5/products/marketplace-status

Request

  • Base URL
    https://api.otto.market
  • URL
    https://api.otto.market/v5/products/marketplace-status
  • Auth
    HTTP bearer

Query parameters

skustring

search for product variations by their sku value. Use this if your sku values contain slash ('/') or dot ('.') characters.

productReferencestring

search marketplace status by the productReference value of the related product variations

categorystring

search marketplace status by the category value of the related product variations

brandIdstring

search marketplace status by the brand ID value of the related product variations

fromDatestring date-time

search marketplace status for a time range starting with the given date (in ISO8601, like '2021-10-09T07:52:19.820Z' or '2021-10-09T07:52:19.820+01:00')

pageinteger

page to load

limitinteger

proposed limit for the number of marketplace status per response page (at most 1000)

marketPlaceStatusstring[]

only include items that match any of the provided status

sort-order'desc' | 'asc'

Define the sort order of the resulting entries. Available values are 'desc' for 'newest lastModified first' and 'asc' for 'oldest lastModified first' - default is 'desc'

Response

successful operation

Example response

{
  "marketPlaceStatus": [
    {
      "sku": "82388894-5883-488",
      "moin": "M00A1234BC",
      "status": "RESTRICTED",
      "errors": [
        {
          "code": "800020 - PRODUCTDATASHEET_MISSING",
          "title": "Das Produktdatenblatt fehlt."
        }
      ],
      "information": [
        {
          "code": "300007 - INCOMPLETE_MEDIA_ASSET_IMPORT",
          "title": "Die Bilder werden zur Zeit verarbeitet. Wir bitten um etwas Geduld. Wenn der Status sich innerhalb der nächsten 24 Stunden nicht verändert, wenden Sie sich bitte an support@otto.market."
        }
      ],
      "links": [
        {
          "rel": "shop",
          "href": "https://www.otto.de/p/myProduct"
        }
      ],
      "lastModified": "2021-07-02T09:30:52.093Z"
    }
  ],
  "links": [
    {
      "rel": "self",
      "href": "/v5/products/marketplace-status?page=0&limit=100"
    }
  ]
}

Changes

  • b1bc133112bdRevision changes
    • info

      api operation id Products-V5 (Sandbox Only)__getMarketPlaceStatusList removed and replaced with Products-V5__getMarketPlaceStatusList

    • info

      api tag Products V5 added

    • info

      api tag Products V5 (Sandbox Only) removed