Multiple Get API

The Multiple Get API provides a simple and fast interface to retrieve Products by their product ids. For example, the following query will retrieve products whose product_ids are 123ABC-S-Black and 123ABC-S-Blue

{
    "product_ids": ["123ABC-S-Black", "123ABC-S-Blue"]
}

Miso will respond with the complete Products records in the same order as the given product_ids:

{
  "message": "success",
  "data": {
    "products": [
      {
        "_found": true,
        "product_id": "123ABC-S-Black",
        "title": "Product ABC in Black",
        ...
      },
      {
        "_found": true,
        "product_id": "123ABC-S-Blue",
        "title": "Product ABC in Blue",
        ...
      }
    ]
  }
}

You can use the _found field to determine whether a product is found in the Miso database or not. When the given product_id is not found, the _found field in the corresponding Product record will become false.

For example, the following query requests a product_id that does not exist in the Miso database:

{
    "product_ids": ["Product_Not_Exists", "123ABC-S-Black"]
}

Miso will respond:

{
  "message": "success",
  "data": {
    "products": [
      {
        "_found": false,
        "product_id": "Product_Not_Exists"
      },
      {
        "_found": true,
        "product_id": "123ABC-S-Black",
        "title": "Product ABC in Black",
        ...
      }
    ]
  }
}

Finally, like every Miso API, you can use fl to control what Product fields to return. By default, all the Product fields will be returned, but the following query will return only title field of the product (in addition to product_id)

{
    "product_ids": ["123ABC-S-Black", "123ABC-S-Blue"],
    "fl": ["title"]
}