Shop Products (deprecated)

GET Get multiple products

GET /products/({ids})

Operation ID: Get multiple products. Tags: products. Security: client_id; customers_auth.

Allows to access multiple products by a single request. This convenience resource should be used instead making separated requests. This saves bandwidth and CPU time on the server. The URI is the same like requesting a single Product by id, but multiple ids wrapped by parentheses and separated can be provided. If a parenthesis or the separator is part of the identifier itself it has to be URL encoded. Instead of a single Product document a result object of Product documents is returned. Note: Only products that are online and assigned to site catalog are returned. The maximum number of ids is 24. If none of the products requested are found, the cache-control header will be defaulted to 60 seconds.

Parameters

  • ids (path, array of string, required) The ids of the requested products.
    Maximum length: 100.
  • expand (query, array of string) The expand parameter. A comma separated list with the allowed values (availability, bundled_products, links, promotions, options, images, prices, variations, set_products, recommendations)
  • inventory_ids (query, array of string) the optional inventory list ids, for which the availability should be shown.
  • currency (query, string) The currency mnemonic specified for price.
  • locale (query, string) The locale context.
  • all_images (query, boolean) The flag that indicates whether to retrieve the whole image model for the requested product.

Responses

  • default

    Media type: application/json, text/xml. Schema: product_result.