OTotto
Products V5

Read product variations

Changed on

The total number of results could be limited by specifying query parameters. Generally the resulting product variations 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

Request

  • Base URL
    https://api.otto.market
  • URL
    https://api.otto.market/v5/products
  • 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 for product variations by their productReference value

categorystring

search for product variations by their category value

brandIdstring

search for product variations by their brandId value

pageinteger
limitinteger

proposed limit for the number of products per response page (at most 100)

Response

successful operation

Example response

{
  "productVariations": [
    {
      "productReference": "UBN-11779",
      "sku": "3858389911564",
      "ean": "3858389911564",
      "pzn": "PZN-4908802",
      "mpn": "H2G2-42",
      "moin": "M00A1234BC",
      "releaseDate": "2019-10-19T00:00:00Z",
      "productDescription": {
        "category": "Outdoorjacke",
        "brandId": "CMWBBRW2",
        "productLine": "501",
        "productionDate": "2021-07-02T09:30:52.093Z",
        "multiPack": true,
        "fscCertified": true,
        "productUrl": "http://myproduct.somewhere.com/productname/",
        "description": "<p>Some example words...<b>in bold</b>...some more</p>",
        "bulletPoints": [
          "My top key information..."
        ],
        "attributes": [
          {
            "name": "Materialzusammensetzung",
            "values": [
              "100% Baumwolle"
            ]
          }
        ]
      },
      "mediaAssets": [
        {
          "type": "IMAGE",
          "location": "http://apartners.url/image-location"
        }
      ],
      "order": {
        "maxOrderQuantity": {
          "quantity": 10,
          "periodInDays": 7
        }
      },
      "pricing": {
        "standardPrice": {
          "amount": 19.95,
          "currency": "EUR"
        },
        "vat": "FULL",
        "msrp": {
          "amount": 19.95,
          "currency": "EUR"
        },
        "sale": {
          "salePrice": {
            "amount": 19.95,
            "currency": "EUR"
          },
          "startDate": "2019-10-19T09:30:00Z",
          "endDate": "2019-10-19T09:30:00Z"
        },
        "normPriceInfo": {
          "normAmount": 100,
          "normUnit": "g",
          "salesAmount": 500,
          "salesUnit": "g"
        }
      },
      "logistics": {
        "packingUnitCount": 3,
        "packingUnits": [
          {
            "weight": 365,
            "width": 600,
            "height": 200,
            "length": 300
          }
        ]
      },
      "compliance": {
        "productSafety": {
          "addresses": [
            {
              "name": "Die Musterfirma GmbH",
              "address": "Musterstraße 1, 12345, Musterstadt, Deutschland",
              "regionCode": "DE",
              "email": "info@die-musterfirma.de",
              "url": "https://musterfirma/kontakt-information",
              "phone": "+ 49 40 123456789",
              "roles": [
                "DISTRIBUTOR"
              ],
              "components": [
                "mouse"
              ]
            }
          ]
        },
        "foodInformation": {
          "addresses": [
            {
              "name": "Die Musterfirma GmbH",
              "address": "Musterstraße 1, 12345, Musterstadt, Deutschland",
              "regionCode": "DE",
              "email": "info@die-musterfirma.de",
              "url": "https://musterfirma/kontakt-information",
              "phone": "+ 49 40 123456789",
              "roles": [
                "FOOD_BUSINESS_OPERATOR"
              ],
              "components": [
                "Salad"
              ]
            }
          ]
        }
      }
    }
  ],
  "links": [
    {
      "rel": "self",
      "href": "/v5/products?page=0&limit=100"
    }
  ]
}

Changes

  • b1bc133112bdRevision changes
    • breaking

      the response property /// became optional for the status

    • breaking

      the response property //// became optional for the status

    • info

      api operation id Products-V5 (Sandbox Only)__getPartnerProducts removed and replaced with Products-V5__getPartnerProducts

    • info

      api tag Products V5 added

    • info

      api tag Products V5 (Sandbox Only) removed

    • info

      added the optional property /// to the response with the status