HomeGuidesAPI Reference
Log In

Inventory

In this guide we'll demonstrate retrieving the inventory for a restaurant or grocery store using the Get Inventory API.

The inventory for MealMe stores have a unified schema, but the retrieval method could vary from store to store. The sections below will exemplify this variation.

Inventory

Restaurant

The inventory for all restaurants returned from the Get Inventory API will have the same schema, however note that in some cases the inventory will include customizations for each product, and in other cases it will not, in which case the Get Product Details API should be used.

Here's an example request that demonstrates retrieving the delivery inventory for a McDonald's store using its store_id: 3aee32bf-581a-47ea-a810-8c0ed90073c0.

Example Request & Response

curl --request GET \
     --url 'https://api.mealme.ai/details/inventory?store_id=3aee32bf-581a-47ea-a810-8c0ed90073c0&pickup=false&quote_preference=first_available&user_latitude=37.7786357&user_longitude=-122.3918135&user_street_num=188&user_street_name=King%20Street&user_city=San%20Francisco&user_state=CA&user_zipcode=94107&user_country=US' \
     --header 'Id-Token: <API KEY>' \
     --header 'accept: application/json'
{
  "menu_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-ljHomlt4LQTZiHA4K8CDIfv9scKD8TrrYeOz-mV9jonTor9Io4SXLocoAI1GwQTSalksXI7m20hfJX15r-9vXNPJrOL-qBUojlL3MCoqcZDaranYVYIVNOCnnYsU66sruSTSLEDWILkgwm4-aJQs3fx4CFyhljjwA3RzpVKcQzF0IjgxUcGjPFHWxjeU6ZiEDCUVFK9RJshsnSSNQOGEeW7TWdHMPeSn4YQotbfIsheBNxmJXg3D4I0r7tcM9wJsP_w5dvCmaynZkD0kx53PLTSTVO1R1yuOe_tZd7n224v6tVW-hCuF09VxzWiedgGwl1kBlv3IIqI7J3p-LqWrHdlj1pMZO_0UNKMwk5j-5kBGm0VC6X4iptFpQVBzwwu3Q==",
  "categories": [
    {
      "name": "Fries",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-rZBg3ffsaj2CqiiamkdMdfPlU_CawDqRH5ayNToKQO04jnZWJStZTdKZllIqO-bgLdI7uq-jw_8hq5qqNc6v2q1TKnTMSZbNjee7ujgr0pWaDSfpz7TEmcWOLkE30ncng==",
      "menu_item_list": [
        {
          "name": "Medium French Fries",
          "price": 600,
          "qty_available": null,
          "unit_size": null,
          "unit_of_measurement": "",
          "description": "",
          "image": "https://cdn-img.mealme.ai/8fccb566f0eec794a6d1a00dfa3b601948c69a2a/68747470733a2f2f74622d7374617469632e756265722e636f6d2f70726f642f696d6167652d70726f632f70726f6365737365645f696d616765732f64623363363936366165356634326538353735393833333163323232643432352f38353962616666316437363034326134356533313964316465383061656337612e6a706567",
          "min_price": 600,
          "original_price": 600,
          "formatted_price": "$6.00",
          "product_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-lqRsEKOp-2ohuAwFA0z8HiPRt1utjYGgEEqvrUOkvCmwZFvJUAHxrsV3fta6F9ZuOVNMy7lVvCFBUGCDEJVFP2fiEPuMhpH5vOBMoyTff0E1gz8oBnZ5T3Z2VK6-x81USFxQF5QDwwhAfY8j-lU30ZG4PHjwbGS9B6WPY1Xnz8q1cUg77yKv_dKc74V2LbUxyFBzOsL8hDSrXHgaOUhvOdDRAl9xPQKylz5gKWAryx9jsVKXPVOuZ3Ys4r_yt2dqEvilfnG3HLsmIDA2IH5s4LoJJfLC_9jKAAIaSnbmoFcQF47n1GOeV7rLxocM0eKrqb9T-XxZCiO0W9hGDxLiT7Tof3x3uZog8719m0ccb24Rg8Gfv0Eceh85fFOZ-n9MDawuDgP_VqIDW1eB8UozmyU1cn_AySrvExuhqJH8HF_aPF_xmf9B7opeHSpyxvOrKnEGLVE5RcPC5IGBFYQePlq0NuDzBvWC8kiioSZo6u3tdpXkYJUmjC-f0KHBaBOkN2bIJQn3ZgWnhUpDju-ua1zfzst9lrzyr9F0uM6fya6Zx-sGueLWHZYjPJfCCN31X8r40ziJzaRRN5c2J6300PiufeFUEcRzQZGtRVEDYg-P7Ta20IutzgFmjLIdZlqsXuNA06H1FyZZ8Mgy5ttIJam8e96ssUo4Na_X9NRlZLy-eP_sasrvZ_8bUwWxSxjSkcR3QoFYJ9SqYiC2PxV_MxvWvrauNPRTK3TJZyQWNp5KYqCjCyR36HxNLVhSoEzyMe5bqDP1w4bEpFwEHy0otGdZicEvkYoBMKj73bsZ-FYuRnLNuSh_EnuO-9QiM2WBIS7jQKR3Xvy8Fost9NIOUs=",
          "thumbnail_image": "https://cdn-img.mealme.ai/18ef4cc6b8a9f63c1fa96bf48c3c2b7ae0ce4b9e/68747470733a2f2f636e2d67656f312e756265722e636f6d2f696d6167652d70726f632f726573697a652f656174732f666f726d61743d776562702f77696474683d3234302f6865696768743d3139322f7175616c6974793d37302f7372636236343d6148523063484d364c7939305969317a6447463061574d7564574a6c6369356a6232307663484a765a4339706257466e5a533177636d396a4c33427962324e6c63334e6c5a4639706257466e5a584d765a47497a597a59354e6a5a685a54566d4e444a6c4f4455334e546b344d7a4d78597a49794d6d51304d6a55764f445535596d466d5a6a466b4e7a59774e444a684e44566c4d7a45355a44466b5a5467775957566a4e324575616e426c5a773d3d",
          "should_fetch_customizations": true,
          "supports_image_scaling": false
        },
        .
        .
        .
      ]
    },
    {
      "name": "Most Popular",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-vpO32bZxe_tYR7JMMehj2VbLdOjVh9hiHQPhmksu7mhPdQ8pNUBKsOEDOCAuwXXkDO2Ir37KqmUh_CuY4Na9LcGsEb_mAyYB2TvEtbuzAo5AUHtmD1f6-kPywxgrsenRA==",
      "menu_item_list": [
        {
          "name": "Big Mac Meal",
          "price": 1510,
          "qty_available": null,
          "unit_size": null,
          "unit_of_measurement": "",
          "description": "",
          "image": "https://cdn-img.mealme.ai/56644401375dd52f55d6cadfa2c6d9beeac0e1d2/68747470733a2f2f74622d7374617469632e756265722e636f6d2f70726f642f696d6167652d70726f632f70726f6365737365645f696d616765732f62396562313962313937323763626561346465333130613932333734653232322f38353962616666316437363034326134356533313964316465383061656337612e6a706567",
          "min_price": 1510,
          "original_price": 1510,
          "formatted_price": "$15.10",
          "product_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-laLnSozBl_UaEIk-B0XFfbE3g3nT8c4XeaSp9aF7z826yr4fFL4_BLNzF6YSDeOhQ67A4WDq6Egy4xCXc-B2iuBXJMNJ1p-BzON1f5b5bUbSXqXXziSslrQBmoakqL5PZcszcqHnZKE8mp1B9eda0diMDyCvV57bcHNc40Jofd84uTgyWy0m8aOf09ulbdHlx7-j_Srvsf_Rdtk2gykKAdRFYOpbyOZuPAVnvL6Kxv8SQ7nTTaAAV2EQwWe4FTaKnWHiXKZ-2OTgxwnO4B9BCzQ-wvRuHDyuJiHrNaAzuWGgvMfUUvK_PQzlNcw8W6a2TxlpvuL1MEAudbs6MrHx-Gpxsf1i7RxGFS2B7RBGUMzWMlRON1wtUjcpXU4_iCKvyBRbSGL0WERKlIkWoN9zvMh3w1r36ofCsfGMH6xWO2B8REzXPd_FiuPMQod5IpLOKH-ue9qgLOvksPmtd6NO55eyb1jnz4DA0rkdfsHEVtPKSTRKEJHsg3tiFsPKYlAVo7gdQuiiPesviz0DXZzoAcvFC42TTVtwKuHCDAWUs_hTPOqcmU_wfkcdcEbBDGCXh2KAvCxycSudwt4lHZTxvI-PBXBIRx2PYze1v5_Vkz1UAjk2qrDMrUKGgbC85iidCO1L3TYpzzndqx7Cui0bZnoGQ2CByaBXEC2ozAcdz_dwdGUa6t-qr2HW_BcpoF9BrdK9sZr5mXP5c4wli1FXlUjYn4mCGxEVxIswDtb4esiqF0f0JOcWf7zSJ9acb8O8mrHbzSqawV--V8ho-A8qK4N7cTS1I7Y-Ey-PGf8n37jebvfGc9eI_SZKgN6tItc_2VJfr9v8oIHvJ4xgKZpQ8w=",
          "thumbnail_image": "https://cdn-img.mealme.ai/5afda5dbf78f6ea6e83f23f334a8b560f1346de6/68747470733a2f2f636e2d67656f312e756265722e636f6d2f696d6167652d70726f632f726573697a652f656174732f666f726d61743d776562702f77696474683d3234302f6865696768743d3139322f7175616c6974793d37302f7372636236343d6148523063484d364c7939305969317a6447463061574d7564574a6c6369356a6232307663484a765a4339706257466e5a533177636d396a4c33427962324e6c63334e6c5a4639706257466e5a584d76596a6c6c596a4535596a45354e7a493359324a6c5954526b5a544d784d4745354d6a4d334e4755794d6a49764f445535596d466d5a6a466b4e7a59774e444a684e44566c4d7a45355a44466b5a5467775957566a4e324575616e426c5a773d3d",
          "should_fetch_customizations": true,
          "supports_image_scaling": false
        },
        .
        .
        .
      ]
    },
    .
    .
    .
  ]
}

📘

  • The store_id for a store is provided by the Store Search API, Product Search API, and Cart Search API, via the _id property in the response.
  • Note the importance of passing a value for pickup query parameter. For example, a store could support delivery but not pickup, in which case an inventory request will fail when passing true for the pickup query parameter. Product prices across a store's delivery inventory and pickup inventory may also differ.
  • In the example request above, the input parameter quote_preference was set to the value first_available, which leads to the shortest API response time. A comprehensive list of all values that quote_preference can take on can be found here.
  • Note that the should_fetch_customizations property is true for all products in the example response above. This means that a request to Get Products Details must be made to retrieve each product's customizations. Please review the Handling Customizations guide for a demonstration of this.

Visual Response


Grocery Store

The inventory for all grocery stores returned from the Get Inventory API will have the same schema. The. grocery store inventory retrieval method differs from restaurants, in that a series of requests must be made to get products, as shown below.

Here's an example request that demonstrates retrieving the delivery inventory for a Safeway store with its store ID: 3c7fdf9f-9547-4fb8-bac0-8ec670c67622.

Example Request & Response

curl --request GET \
     --url 'https://api.mealme.ai/details/inventory?store_id=3c7fdf9f-9547-4fb8-bac0-8ec670c67622&pickup=false&quote_preference=first_available&user_latitude=37.7786357&user_longitude=-122.3918135&user_street_num=188&user_street_name=King%20Street&user_city=San%20Francisco&user_state=CA&user_zipcode=94107&user_country=US' \
     --header 'Id-Token: <API KEY>' \
     --header 'accept: application/json'
{
  "menu_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-l24QwGIBjrsjbBYibaHJtZULBdF_oogtAg3JN11w_V3bXQYMRXKNwdwGJVEWGATlGCv1C_Duv4DZV7fC6iw5ss3Aco0KC_sBY6rTphpIZ6Kfzxxv9Fz-2TaAdNrm8CbJC5XEtVMlAq15wbz0hZTJvHvW_V74BmpMcHYucVIrjo1Wx7m6fnLgC8wqtpJW6r7eKe0YyE0-13CWkN4NChETzUXO1hQjQF7kiI3bcikqDUOkDx7RQ0wdtrNDQxAzYBIOc6dkhCtn4rEVuWpF6uxNEI=",
  "categories": [
    {
      "name": "Sales",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-u_HCI81HQoqDyFWdi0dDn_GfdGGSQPsEfeCDH3gfsneHtsdt4U40YjeP5OGOeRMweN-1A2t5IP6_cUHsThNX13ejBvnXj8xQJb0kzsz8RNOf3dG6Kdup4nV8GtvjFcZyyZzXzsDQU0NEmYcbMzQPZc1fAmFyYcYqqHUhdf9028dcWAKZwIdcRPBV9Wfds-TXRkEkNICEvoEKHPgA2FZoimApDkdVQEIpriQEZk5f92KtE7gM-b5khXFBbWcchn0Ro-v751ybd3_BRy9abUn0wVscsi8lZsSjVefOM52rV8x_MQ50Hv6vXSOQQPK16vOC77UbpTBrH6ixpjp4HjwQTVXNM7QBOLcNfsrF6sYFxZo-g46wqonag6KWtJLIBd2rXuDFfF7fqThyI_Z2_eUochlM8MhvsY8xXecPDZtXF-qxtjAoXBWwiHzptfNNXp1ADEeuG18kkOAqzHQai6yecrwf4setzpu8vGD_Vb1zGXy",
      "menu_item_list": []
    },
    {
      "name": "Produce",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-oUKixAk362zkFMa_F2sD7yNmTDCz9P7M9I6JkNqtHQFRbWyCmOLOa1VokEsDrYbOR2ZyY3GEYGSKEe_eStIRyIM07mBEKHSuyMfi0ZP3eP2O7gTazOVvt8RNdbmnIX7Oh5Y3ATuIgP3fSPBDhDXoVnvQwzEJHuXFgcCFBGMh31oRNPMpkoYZJn5J9qBVfpJobDAEYuBQLIy49FIBKoAmlGYwJLUgUbR4wBj7op3QLxVSoQrzfXLq1mNa-0bafmth1i7BvjgXsV8z3SF6D6tjpPxTrFMFMeCC6bag-kVtXj2A7In5nYTboV3EJ-92LG57oO_efLZVEcWfOkZlkOTXOMLmLcMr13zMxg6MnSPEes8Tk4oyoLm5cuioidI42zka3I6buYUfIqtSgUzr0tiM6qAR6VgtlMATe2wgTw8V3QkuuyV9pYmkz9d9xzY3Gm1Rg47ftXpK0H0dgfn6vRdBAgnnnjBWozQeggOed9Y2Vc1",
      "menu_item_list": []
    },
    {
      "name": "Exclusively At Safeway",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-sbT4gNKUb6Mi48B90WsS2jVQHq21nw-tp__Ldsn91ZxH_6TASrZyf-EAg8k4K0c-mrCQhK2wYHsRi6TMGRz1Ey_tLQWwfxUV3U7elze7uYCnDf1rZ1-ZpfQEaaLmkP8aLfZe__9vKPC0H1or3eQdACVvdMKdvXHr96qiDsyZw5lh92aUinsnFzY3LPT8XYlCQy78sH7U7xEjujqv0h4-QCBBc16Zp9JajuKN3XF_Mgo180a9Fmv33jOoZJYpRjnHnLRozHcfuwQddjisCERCrXffQMJ6mli5EzCEmNcEQTEATh8dediTPNL4n0Erl398aCice8felPQBPiWf7_Rmdmlm6j6WXpOQ7Q4dl4YiZ5VyGjNRmipgdOq_dbBY7slXBPEW0PnWNXEEJUJTng4qnxZcRT0OHdGTtbVAdlXOFiJDyXlyH5gvKmlOWN41SEkn_mhAiMS8kicD0jXy1du_dSglQrz7gb6e-xMP0KErRN7MrxsSKuNOYDkvTG1nYUkHA==",
      "menu_item_list": []
    },
    {
      "name": "𝘖 Organics ®",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-j1yeI15V2urgnj3HLJNfDx29jrTibLdMnqLjXwXO4l9AempuMpBRrrUehMDfxArRhJgpbb3fMfgzGLHotwxNrcZc6RtnrqOUWoHyYwYj7JMVvphJgCyzzWJw1zsAggxfDgNRHuW-pj-KDgWWmtql9bdbc3TfJneLr5fj37sxYnlQeC8HXYBg4JI7fL-m1p76SxDAq8YG56zVKx2RaSOa3y6pfNXlt2JW0CSsMJfveRX09-MCvcKVZlODNlHjJCl1Kl766rDcAOxLFKiVmJr9Gu-MbSi_i_nQqdsGUYXjgAIb5xTwqJ_IWvbxGWySn0YLAw8Xfm90wSLIhrvMBL2XFTMBXXvX1_a5bNx4JI6rBQZe-zrP66mK7bVnATXKg10qoBmzQ8tMa9Y4SU6JktrJ1WKFtJXNIo4sFgiuSkSeS8Pj7oz1FVyE9G4lSmBdU9kzmeulSnn4EBWCWkBzwho3yhFPvbmr-3xQHmbl-XXHSaUOHK7SmEYbOxXx5PDi9WxUg==",
      "menu_item_list": []
    },
    {
      "name": "Condiments & Sauces",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-ndk9ScTTrninerngtXVNikNnGQj3giR0EKsspxZRPnVR-Gs2cR9WuljRh0G6VGExchlDfx68tU69EX_a-AYeINE3nAmgn3X1-NN8kB1cBlPGseHdtnLJafh_2as_53rgTep0KQrWwhg4RWyg8wWR6uYEO_oLSDoU2YVH6X3whuqRtVTH0zNdmMWjoZpXaHcPKy-3yROSB1FretXwKPD4WluYTzGujez1dIYMlipHn5UnAINaU-dq_6QetBuxp2A2AA_OT1OA9Wvpueq5pOirPI2p4i5-f4THFgCpbAjQ1dNeJ_X59KU9mNxbHAqsw3f7_8UP6Nn7jccU7aNsLy40Yz6mJBtNP0dv-Y2yO130QMA5nk_z9bGrHkUSAQcDJtuh37ab5lAR5QcqzNjS-b6UoVqP4UykzYkzk2B_cbLJWrygbo7MszvYuVL7dLhYUGv_Nwy5MlRew91INfMA1At9Mj5hHgbwXhKZrHhE79rpYcjiiO4wmlUklHmOneInvp2cg==",
      "menu_item_list": []
    },
    {
      "name": "Beverages",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-pi_dWfUYyDkl1yBVEwYex2WeGdufNu9asaRTHUUJRPrypFePcEXKw3eduuAdzIoJWG9cX_jlFCY4xzXPGkFweD0ZfJ4ZP6Y_M8McjbfElUV8gkGpUUhjfNSCYC9oYlI1l5qlP-QuBJwtd6cZT4QFwSV2kHV48tdExl5fxcC-MQUhOTainx46goYJzcMiDkyXvP1oezqXlSlL8OTX1mhkMDjzQZ49yPmX-jMkPGcBBIdXTp5zqJL86MrBur4SZ7I0Hl0fU6x3NDzWJlY3Krx9uupnLiyTMFUzUCXBNAZZdcnBclcPLTWAVikKaRb3Y4t0k6GRxWVvlIn3bYAyziGth6M5ZEfHBxe1BA0_gGMDIQCfjdZxoyc7zvpzdAyiH084JGGwqiZ0LPsR6pvkJoqOqq2_k7nkium2Q5w19Ng2jHKSQ3xY6GCOnGcxUt2EgC3KodziMfILYEwm4i9x68qPP5Ho1oWRR4wUz8Z_wQdQhW0",
      "menu_item_list": []
    },
    {
      "name": "Deli",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-jClNo3cO4i-32Z7CdmW5l23Yl0_Yh7D5vogQ9KE97DgcvAa5s2gN0wc25CYJDrDqkSX6h-8hsaJ34jhJ6zcExA2bFSL5u-rEPP9wTC_NIzzLLAzv2fdwygUyAcC5RVX5R8MmrmFke7qB_x68vasMR03Fq2RuaOnsQpMPUb5EVdAqQe0uxwUy8bcnb6mOf85DJW8-w5DJASTFQ87HkRet_gQ4HGOIFpPYRlqkThLMHhaOAh5rrGGzGrtHf39w-uh7f8BLstLwZy4II3qbny649jU7guTUw96cmpHn7O_wtH715mtZBSFmGit2-C0LFkedZ3qWYCWlrrgcKwNZicgSEWlvdHChL1pZXiTJBqpjColBDQ2wVjsfZrXDNe-jeCOcc-KVzlzSsHqF9IclHL9u6llgfEisBQR3gh09Zk0JRroB5wR9PALDwfPHYqna4XLiRo2ClSjdP_S1rKcia_aLgiu-TmeLAo-Q3WwbxFWMj0D",
      "menu_item_list": []
    },
    {
      "name": "Dairy & Eggs",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-kLBtfifdzWPtGhBkAegttH51c1trklHuDseEyk08L0ksicwFSFp8LjAylecVGdPqd8AZVDs2CEDjrsL8MjrGY4pWktfW1NoPw3-5t9G9q5vOHM-zDuqH2_pra3Q-eiycVd491RjtxyAACkfBFv3rCh-ZhSEf2kS8cSdn5fiHWh-rb2gJcHeqGoFjzgTNjiLVYZr6-gSZ1I2IjqHMRZzNU7vj9y7EMUkzKja0Fr--zSKPI4HZn7hzWJkVWnBD64NBbm82a-N0nez1U_W9l3PrdBrGKHCk96szhpxuMR5iaFLOzcK5YsuLTzW4yDCCNIb2BxKnGIzsg2JWG6fzys4MLbFLqVH_gCf9iioJVkG6j-YAyRo3U1R3E98PoqkEWq8Ihq_LPqgMRfmc86TCFIk5B5C2leJSOPqxXmbOozUcuYmL7W11hM0n4BqNbsb8wDtMSFflSc2tiiisjUgFa2cr3uQCZrrhqegX3XDN49W3_LPhC850Vl-ozkRS_j45zIZFg==",
      "menu_item_list": []
    },
    {
      "name": "Open Nature ®",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-p-n3jxuFQIiwDc7XHMTsSyK2_DmDcx7gmmic4ELDY2WzIu-U5iArKdS3VCoZ_7_gQXrZKzM8boa0cxliQwt3MvlJFAsA0hWLKmsYp9bpTrGBl-qqRCZ1_s4rfpLRmGpHRSY939xf5ZB0IOr2qYdK97_lrq1RD09TRZ6SvQS305p7D8SG8u2TuoUKISvZizv7MvtPIIVkWqVbf7QF1m4iU10RAsQEQ4PLDo3UCftMwvN9FvCf4iVG0oNZMe0MfvF_05n_P7_Z0bqPJGmtwEEM6SZ_fF52DHKyiUtBUNPiRJwfiWv6YE0TlqHCrNztcSMg4F3Cu4JvLH4t7cpEZyUSaKxI6CIqIygz0X2vFnt_IxZmxS3uZvzb52WqwtnniSByK_Q5dmF5JfUblQc6QPtr5qjQSFj2aw-r8SOquu06Gi9a6kJD6E5DkbHvNTmvb0LclK6cmcEqkuIX3f7NiFQzVQ5DfL_uhu0aNmF6EMFwz5L04tjMtgcD1b_iJVu2z37Rg==",
      "menu_item_list": []
    },
    {
      "name": "Miscellaneous",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-tBorYBTyzJdOLcqOMnU6i8yPWhSkUpjM4DmnoVjHAMCiOIVvtnIRFIBJCVCBrs_JIkmJtKokpSrqiy_n8RQ4-wgi2nmHeFza_ApEfexetQm5Vn2tjOVdCQDn0ZPesKWnkMT6Ys1XRi55VCzWc3sfhuIJeZbKMP739GY-OzjqhXgG-tp1fcZXTWIEtse-03tjSxhEnlvIgyzDoWab00D7J_8j5gVsbtZVth7ASxtsIkFTwHtsEuIuks7LMl1BBBYHkvDajtzk8INRL6kF-28yicbsgdqukdAx501_JRoyyLaJz_OsC9s4Z6nNtI-i9-wSkKgW4IfowgDF70R9lOPika5K2pGlCjspUK04U3arvn5vHgxTagOmUKeK1CTg1Yqmrt0P3XnZNO0Snn9BI03uoh91cCua3QvJTXVEDzTpAuknlik4rcbKPlEUfrSd-21yf1LWTdK5xVPMKpaQJBtuvGV58nVcXSrxBFjBiEhCfeSvDhCgew6J3ndbMYPn-I_dA==",
      "menu_item_list": []
    },
    {
      "name": "Meat & Seafood",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-nPDKFlavJ3QUn6eJkUJVdqGCxMQWa8JuIBxwfG-SMJTaRlTAFMEI7nXZQbOTixVkDnK4NygrhywrNpm3InLAHc82FhyApbNEGyOXHzEVcBO61IJzK3qYST6TdKnZDxhT0jwZqdWSo8cWdQg_My0Gb2JzBLesOaEHikllcsu6A4uOlxliZclK7xcFMVWdNQWFhcllWGavg9JV4vFggtUQ2HwfOEbNUouUeKkflMfI2CXih9GaIUASRngwLZIoLVP2cSfpqtrAkA__fgf9HzgJxEMGRjRGD8UcD_4ruDe1UdlN5Gm6JCosp4DGyKE9Tlom_0ZbL90sbCgMSoSg1SluB23L-NgqQCyCuFKVaaY-BQamntIW6-3rvpCQ2NXxIv-Wnd1G-ZsW9pe8WAoJvjW6W6DMmypRSZxE-W-QZxBcYXXOj3BML3WKwDFV_ACT-tbSgvZ0GHdA9Z-BcwHcIPCCod-xpxJofDng3ybwy04afdQC3sMXQJ-tx5eSSN1ulzYLA==",
      "menu_item_list": []
    },
    {
      "name": "Frozen",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-qf8LvIUeoBsdpXq-ZT9Gcr36fplTxwW_5Q2kcj80T6JJ8W6-JsePSTl5E6d76NlP-loTZFDIlBc1RB-HJq3Xt9CWFsNNS0wqN4OXpegZ7tPh0_pC9LbOkJBReoZvfcXeSNHUEEpFUjrH93A0iCtYmDyHe2Yt2h9Bv2u4_wH_sQkPqDW6MZlcblJwh3j1OdkK0BbfmefZrTGeRGqtn4Ujns6ijRkR2V4RfCs_eppkdPK8NviROwyN0oMX9Lk1AfGxr2qOIOgZ2U21oQrqrRMDAOoY1IdoCQhNn-cn-31Ix9cFeDjOnjseqpC7JSCTQf4mItY_ZnqlKww-UDcMAtdcibIKBEAketBhD5Ag3OB04oZlo2RgP5gLk29QTkxh0SHbe50pWvDQqk9_yEsvipIf6tShFARAitvgV4OfydbqemjZJfzax9H_PitwckDEdwcifSGd3IRCpWtj2kuspcr3dkZu2G_shkBV5e-TniujtBP",
      "menu_item_list": []
    },
    {
      "name": "Snacks & Candy",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-mrGMZRqGziVDCHBkQ30kG9ry4PrFhcFp59ONxFnEjQYUhk8Qz5YkII0O4qwU-7d2sjMyeBRnHmhvJhQI_xQ_WI1WxKom9-qCj_8I-Y7_c2yFZVhwl9TYHwcOan26vWG4_SRFOxXz5UegeHwSSdRaxpK5JOHXS_UWvT52s5DkaQpJwmgqeRFTGVrbmwL2ERigg6FnVJfz6lru1h9zralOPwxJtPskwU3JnTDBAX74B6JUEISc17vxcu5TPmvwt2bA6TE-1HaG_t8hGsxdE7i_d2e75N-wOmIWUv8ySIvbfgc5pGxJxRSTa933X2i-iYJ60wtBvxvycWoFDIy882uL-28jibCWUO1vQwnP3ceQdqUxQW-pyYgFpHzlqr-ImnftiJduPB0OyqCUg5atGNyCiOeUBH7Qcfl542qwFCna5gRztOBrGjGQvUmi5HfjwrmrBo1pwlT0hABDNwc1mNIdGfswNJXU59hcN0MY9L1DPwGBwvDTpQs4jGnZT9VKgzYLQ==",
      "menu_item_list": []
    },
    {
      "name": "Breakfast",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-p9JcWhxFvdwmoRg9WfhVBtgZPUJLR9nvNKavn0TWVOnUtw9XvSdZu4SVx1du6iXCy0XXdW_ZDnNYY1FplMOkVTn0HkVIavWcx2rPQ1UgjTRzpR28DdmuDqqJaFhidtfri-mceTe6IQoVKIg9PG3JqW-Pkaqsx277_PJmg6br-8Ron4hjFy3Nwg0UMeCpOZLaB0SEhKO1Bk5pLMX0DTX9r6RY5-T5pyL1uoqr5f0ICat1TKrg08mzp8gKCNTWPXoxJpYum-f-QRnAYqrS_ADrvPdYD5-bjV2ycio2rpbb-DxBmH2_WnIu3muCt5GET9C5sFKfxmK7o102d0INq2PVnpdbN1CqFewWzVuDcZDDfLzaVxAJ7HcIF4yVErKckE_eJ4oBCps4W0cZyI-mXOyQE1Pm3JxpB9NwVG9F7UR_MgGY-UNiu4h2CJ_b0amC1A5r07Imh-yO4YfFoHeGWqpEinxF6VSeWNH2jjLbsw7jdV9",
      "menu_item_list": []
    },
    {
      "name": "Canned Goods & Soups",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-hepDTzyWdbE80RkBC2H91jBSMrDD-uqTeM2_q0r3CXUgXOzVKCIwBJIpsEs6wBhVecwrQ-cuEQqEEVRwYFwL0k5jk-0f74Y5oPUPKqHno098ufW-PFMX2w1QwOVLa9trR4a_nXEldVfddJqy8wCJ3HvQLzAI3ESc0Ic-cYUc22MK7vom8DwcY3IwjoZHrRa1_H4kL-0Vp5NAIK8J4n3P4wTRel2x-qIux6RyRtH1kzOyZD_jUUPlgIzK2w71H7uwzlID2uUU9llm8dgPXYoNw_ACuGVgZTaXWPo8jterQF_NG9ap7nPBHZ57In2vhaKYlECx3LPtUZbjo6c8Awxqsj3Rab18DXNYhBtXqmSIvPhyQY9EFtPZ4KOIdR5l4cFneOM2msVHeTSi9GBFI5TdKMOV1l_vNIAS1K-7xxjUBF0N5ZMtXhqw2Amp1FGvzOaUXwEf8fZsXj46-6wt6YbCogUciZD2rqQbn7Rk09mCWbg4UNNV-gX11BpELnPm7P4EA==",
      "menu_item_list": []
    },
    {
      "name": "Dry Goods & Pasta",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-loXBVINN6hIjhlx-4nv-Yf0kg57_x8HDcRMxoxfHnIP2yJeUrhGfsMYJnOeVe2gMfwh5w9hPNFjXHPnwnxsHn2lk2rp_DEiDcShFaZjl6zRzLiywrfeHt3vs09YF7P_aYoXccC8MTNjpujKiTR_t6vGLnTwc3p4u4KyWHRWnjZqz5QTVH3KTDjuTZn74WKbQI99wq9zFermuGsG-CTKlMuK8pqhpglEVjBOtD3xgIkfXQ8GMSOCf-CDXD7MICAiDm_F4QV28oYH8pUE5y6yv0AbpexGXWeZhh9rIFeXT2Mo3NZ0W8R8S2oEO4c151-BhYbPEFAzW9I-JNuonyZjd4nc2fKr4_8wODSucjWjUvCaWxENlweiFp76Jvk_ePoQh9DuST-afmvF-m1pUl0Pg_Z-y18aa4QWS-FiXMB_0s1Y476QKc2_uLCRZvNLm5eOwDmGWGsyqYnjcVoztD0tgeYlJhMxLndVkazkO8CyUApbEmdiSWz7OGKe_Uxng4WOmQ==",
      "menu_item_list": []
    },
    {
      "name": "Baby",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-s6SV5K1PZaTBpvTd4uebaaDAXbwOK1o0LlzqNIMAKvg5A5Fa_I1O6GUFKE7Chn8Vj5B0wtVX-T69BxNfF9Suejg8gBlAcUDdxmcx532o4RVtPxYQTZSaqCVYfJPBPze_SYj-4m50wXHx8zbxkft8v4g3JlA0XH90raKYxd2cE3EjOtlbuJr8ErhSMlzvRWGsffOyiNVyLkJw5AOd0NOHdNMK9Jvz9jQloRTND28kN_wGgJ4zla5JLy4f7Y6Zmt6zV4uSATFFKc6GPV2278R4mdatf8PnEymmEv85GlPwo1qR6GHEkZ2Veo_JUxrN_djfhuQ4TZn3m7d4OI5rG6hhudO5JQDxAvv2c9yMpDa25CITKa4Tme1DKKWvVn1X2YePUXna_q4DwmsTAl0wfVFslDC1_qJBApiRTHREJV4RkLxsl3wqET4p6BcPVUPuYEguc0i16fnT383PwHeUxIM2lWIkKXOPiaRxkTS7m9BNrlm",
      "menu_item_list": []
    },
    {
      "name": "Bakery",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-iE_T4KoVXkxbRTmYYo-nTY1hwnfiN7tDquBRgRY225GUT8hXheAOzOXtqNc3KAXqjNPQyS1TYiW2DiTOGvayLbh_uW5_OBA5ZxKlED5IRu4PPtor2isySyuv_6wegiBUOXxVFw6l98smtRSquiHk4g9vLx3CyK0JNUZ5R4yKXYS1pif4Vx6mb4jgTlZ0efOyxq8UsB8_jRsDpfZcIzCKHGfYdxfGCrt8fIYxmB0u7ZyFiq3HZ_j8isScGwxjc5rQ1NU6NWMnMKHKx89rGO_9T9dJw5PciPYQ9vK29wJ2F0CxEDHLlGNMuKKwpZehiP4lNHOEmzK3rFq6POb4CJHlLG13dy2q8QT1Mif3BoGhG4HMIwtF5GAmoiUaeBu63Uy3wc1KdmHE63aNGFLESg0k6He04Wxtp1M8eTLUYYZ7AqUEzFv2h4pTZjxir_a0NlPFdpEoRIbc2bX9PgrLOlF4twZaqFHkNfLgJuVIBlzyVoT",
      "menu_item_list": []
    },
    {
      "name": "Ready Meals",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-hZt_XGXvP8SCb0HiQV12uW9GQN3Dp8kyR10wthCL30fkROJaFFCb6tPVOij69rzX5tt44_2LqLU60uaQ-UbN-2JXmLk-e9pPyntQ3U-dD0gSYetLj0WPwrCz5ZaJyAzS1VqJOqnlksjLPLcaAgbl5vwBA5k250bBv42YxfskjrfwhIo_uvePim4waQGp-vzSWXiO34yVDLkdloh3lcmbGFNvjet-KjpvQ3TfBVot2l-4d_tmaIGJwY8wqqHNw4ivkZcZmyvwJWMgwejFaTar4t8CUWun538k6ABSZ6VBhTb8Ds9vWkOaR6XD0a2p2HT228wLjVa4oLwC56ud0CAf6Kkl04P9aaJEjjXrwCWq0vjZmWDZOZFFPb5-MztHoUzf-55IdKzC9UkV5rj0B7-ulZFYFxFuDlHOmAd96uv0MTuGZMJRLYYtZsbncaazI4nWZjuv4rYaqOxQr8pPZG8UkW4MJ9YzndzOhYlWcqUyuBuL8OGOeybN-Q2k6G6NO9yFw==",
      "menu_item_list": []
    },
    {
      "name": "Prepared Foods",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-j9g1ExqRAGQqcB1o9AUdTKyXhpUEQAbc3CX9C-FotjjTCuMXrCqXQ62ublo4xLDy2dmY4UNm8koFyrWDJV8bysjNDlB6RirH6_YGyOxTG4mPMTVzs6DjKYumkuLqZo9M0tjMxxa-Z5gG8gsLxgaJJftXqMyV_7VTYY3RqdizPVRhjyLmCbrBXMa9QTki-QUN_ZjNpONZDJT1OilkeiNq9hIhOBuEQ31-XkE5IG-RsUxc0KbhWf8hSGFQqYxokxKT51lLjtd0OjjDmOOemmdjmhkauqHVot8tsCDpPtAiVZ3Y0tTC_CzDBSS-USQQibWLrtO5nHEi31P0BUn7n6KzJelEZk7UHw6eFhgUG4PmBlSPFtpYuHhn2BaxYeZoiF-hTAeWwVv367IPv5tzgWgWkETemS_oeTHjf9T5wdoCKuXnoaAMazFMYliBtXVnMhBZmG8IZU0ygdcHbzS0wGJlUYtg2vDn5gRiB_oxkWsrIgz1bUgs1hyqhnXaUz23aavRA==",
      "menu_item_list": []
    },
    {
      "name": "Wine",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-lLhTfGbt6WTNfkhY2BNOPw0z9TEbiK0ltp5C-pUcNFtSomMYJuocJF8e377R6xU9VMfucEDL3LA5_185wiARiIxGTpIkZBHNRSzuWx-V4dPug1e6wfw3_hILwaeEAhx-Vh50ButNrSlJBb32cR3WubSYBaId_dgra-ukEsdXL_H9XiZALuwrRa9007YvYJfOfkxKTSOzMU4y-PP-TgmX4alzsKUPiKPkNoINdUDGYX9_DbHKBQ_NNfSW2VCoLR0gakrvtuM9uH220h_lN9NMBN1MyIfQnqlP0z0tAzYA0BkcKlYQ-xJRguQVnR7ayZAZYGcFQ-16v_IucUwOa6U18RpKr3PsOJNFqet-qDZ4dVTuUXTZHuwoFilZcDBu1BZ-RM9s9PJexIZvmXB6z3JpSXl4whDP4JhsUVyYaq8jjZKe6tc0Zl97A5RzOG50FZ_hUmhMSSAxuq3_RXZuBbxDGdS2rJdsM053SnlmNLmVAqL",
      "menu_item_list": []
    },
    {
      "name": "Hard Beverages",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-ta8B2IQiL5ijppYBPhDHbGUKv7d7VXBGKqvPooJq_bzeUjtKBkS_eQ1e4g1oQMddsvdkNNE_6eSapKw2HOdHXwkuthP2MHEyCvr2GMRegbYFx4BxSyAMVOWgd-C8bA6ecRmagB3w0r48xje1lN70YPI0wFBxDCPJVpgPNY6lYYkL2E0AcRXq1MPeiBF7Bj2M2fVZU9cMGfcq1Cf6jryz-SfqFWngUf3mpyro0lK_dF_P3mjUtiwRRnd91GA4G-IBREYLfUeB3FBrXYjogQ9m28x9j6AVUrITYbF_LzJCEn25Qg1yzpaCVZV2I1ZdITN0_y_JYXPsOzl0hz2GQTSj6cJMLaRCDW9rps5edXlVETb_v9qrq2RU8tSY9AOO0E8AWkOymQGVRKKnOBsUNNZRWH5BdJpmxYFspv_tIRooHI0MVq-DFjjrJ7NoiVSF5BOE7rLhFiKwrvzQ9UAHaRbpGuxz7FVbOSAguWAtDa15NtWMUIUGjjNg9WQ9Y6OCLruYg==",
      "menu_item_list": []
    },
    {
      "name": "Liquor",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-iZOvoRHMQRQRMGaTERUhckWvOMKctOHVS9kuqsooFg0Om6_rWyXXv-Fcf1XVrOKITpx3VfitGCsi8pa1Cas_jxBOsHX3LIJBfMPETFor2DOA1-R1qyporjwItYk5oU0mmHQ7DLVtxkXZr97q5LhvR4a_iALpBH1_9qPLGR0qtVtDTXb6bARp-lM43431iRqT8NRGRd-_JSU8wl2wGWeKm6PgW4FeINTp2DgcXfmVMjU6suz8u2pcCMsNYRQAgb7ZXXEesFHS0WrarRIBwrf8VK6Q47Onwh5jJ8gJ7m74mi7HyKxKZOBvLgGB1DsObe9IHapIqJnUZrPaW2VqqAD9KcPt49RoSRIo8S5W4ce3ZyY8tFxjxvd-bXvfPsypCxXh_LU6XXsftLhZnnmJ2YemvmKVSg9Bzjqtz_zeemKihVGYfwCZYX4AU5fvKJ-dKDu3Gqd3eXqPyeEopKHj-mnHU3Zf3sWSCihWqgOyH4_xH2s",
      "menu_item_list": []
    },
    {
      "name": "Baking Essentials",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-nUvcNvnxuRCSUwdis2cli8JD231OwbiUVZspeYBttB5xc4KpL4BwSgVRdShZoKkg_S3CyDGZQoi53W4_9tzaBtp8CqsZiMeqcuPlteAAPZipjo6wWrlkjV-XGoEfdfSkoYtyUUlde-8M9wMEZxDv5Ed2lJGEo6RPzvP6aA_MrEXVsd15mIE1pdPsb6f02gDTDW1L62FqLFp5eIbZzJafeq7Lmz1Q8a-jQXXgz0hclcy5gS-FjXbZHlYnpcxJ1uXpP3BbR17xsEqQuT0F1qUskR7FUdXBEp5zTeG0zeOs5PM1rMh34QPNIfnZARH22iITvUa2tDIN7FGgsP6etdqM4oxGtRROIORUTpbipRFtYF-Iz06BaPXrGVArlNIoXqkrPvBUA3UIpsjvP2K3nLze5xIGXV3TCnfUVIr8qqWiJm8udphVawL5-SSyTnwOw26D4HSUsyzdkGrb7inOkL27-o6PsOAkgg0xmzoT1bCYD4TL0OfcZVTWFLoYY7wkUkBWw==",
      "menu_item_list": []
    },
    {
      "name": "Household",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-h67DKpKHiEibnMPPiiVzjOHCQ4WNsZdUsJ-ysg3bQnxcflOWpXjZbCj1FxgBmquVsIwGPdV8RhSVyyWlMQwPvyEioOCwNLMsO9kLDknT8oYeQXcG2f_FKgCmHyC08xm0BPdXet6P_V1XwVw-Y4MXj8NwhkiVIU19p57hFg8XpU9Sua99czXZn1sk1xBaSNBGbu1FBlBlSMGyL5HI7O5rw1cm3FU7pgPn0rTYHFj9E1mCPiBillAKwBVp1hxZ-1h6u-csIsbzsPc6aP7qgedTPlNKXbfrjvOKlDhnbtFJWm3OsagQpjRFRsGpFyBxk_9vX9LPp7dQzITatLAtc7ctC2Hqg4nalpzGl2pgUYXB2UFNlSR70wGUD1MRtkbe6y_TuWWBsxGa00gS7H7AJpqaOsDTKbzipc2_o1LRsk8dgDhk9xnByRhZfTfzclUCYFpeZsUbNf3CHLnOoamEZNpYfTZ8wqBjk7axxcIIVbAOcl-",
      "menu_item_list": []
    },
    {
      "name": "Office & Craft",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-sfDdk8w-SXN66mFzk629M46IFM2WAAN_Sqpy2i6O5aPvmdOFvZYOTL80YJ5-lDH5_gLZ6-fKeIcgZc6GSlE5zGPjZ36Mhz-PN0GgKLIqUlej8x_SxwVM6ipGLUVSHGQqi5zGPXz9FKB7h55_4QDfNsYGCy0kHw12tiIWJLlt8GjSyFBLXajKai5z73WWA7Dr21KxWBiwJY1v9LH-TbXkFLd1vfOU28ukiuPwkrNKJNzHEuUMUy6IwRiPfVgDzU_LVtXKq24B-ImXOHNCaTCNgTbLioMf3PYz_dfm42SnC9J6T_a0yMgK9s7pF6gZKMKvKu8uPYX1sIB5RVUFW5I-cED4Cu3REq1y8Pv7-3adyhXiw6Mhrv75EXs3-_7i_0pTP2iXoBeWK8oqGoTJueOjQ5oitdd7t9epE3-yDQj1nWWNrFT6a4lun-1hiT77eQnF14oWs7NRFrpoNr7ZP8i_kVM8ochb9zahcqdiWOAGUvkxsWxnSpfYPO7rezYpfiAWw==",
      "menu_item_list": []
    },
    {
      "name": "Oils, Vinegars, & Spices",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-n6l8eJ4ZYw-6z38U1kDE-lI7FlpOQYcCA4Ho_JXIjy1HjWb4CshR8af0ep79ZdFRP6c-DEFuhbmNjCmVCUTXHUIMtBIa4Ak4PLpWuFBYeqqr_zGYV0tu3s9571yCi6TKYD19W3BEE-QhtpUrKILnvusZHHtUm-smiKQqxc-ZRD-2TlyOGZHsnN4zqOtt3pepB2WLOt1Epi94sxGJsLIwWYC7MDwXk9pIgYe-KTQVAwG2_xShRoCPmRjzuovHDuJx22J9AZE7XqG8KczwgaeuWKkbtNuIfKb8mdGEpKwV5aUzgQWjAOlwQwzlEs15Ppuaf_V9mZXr6OWuZISoaMDwyyL149KRC8Zo5mp8UZ45JbLcCRXkp0a2xBdMlb35dBmY8omoPZJC8ZrCIQaabpVoAV5TEERy-6NSf5QA7CVPfm6vCvMQL3nhSa-aiZnfMpOlS0tFBfBcujbHPg7N1MY3EaiImQs4eKFverQfwBV5-kVav-yScFkj_SyOKNy4ITUVA==",
      "menu_item_list": []
    },
    {
      "name": "Health Care",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-lm5Zc_w22HNOr2OrVqn_GUnOHcgCtousxxFGvTYn3UQ18ax07wxVe_3z2dMk7pXFd-U3Jhv8ZinGthJedFREuZ0sh7SG4XaQINY6rQ0Gkk8HYcdEUzdjhVtbEHoKT3p5jYIfhcz2GJnhf1I96sCqvuDiXyou0bW83CbyqoLV5KKTkr2lqAZbZWWhWgFHGIydnCqL9EVaxmSe66KU_OX_srh8fE4LlvAMluXuxqWVtruzpLQZtTCzs-nln87cEVzMus8ISgcr1dLzgQUK1C4oW1HamDLWReDu6N-7KfE6FdnaLQ-yD7AlgIgULDDvmrjuWKj2joQvRoZ6gtYIllJMe56laS6JOJ0XXYI-oTL__6JP3OgFfmTnNE_Am0Fsv1t_sKvybdex9BlUp6HyB6T1QqAmZs0JyzD5en1Q38svqCcZOOq25m9SfZGtbj90H_kiEbMrnxqYQqLnZNOda_Aqr8qYGRZHdcA4zVhL2W0otGWwQFLZ74iWhOjjdBx9T0wLQ==",
      "menu_item_list": []
    },
    {
      "name": "Personal Care",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-nwZUemhmCQ_ZbZRIjzXeF-3SB_C-jajJhFNlHqTdhyGfzjLgZWKHiUnmeGG6XPR9NcAO0Q8vbteUtgDNBKct97gGI7FwqJpKIfkHQDIIrYKkSZqVvkdEgdKPXRTNWw7sfQ9F-GhPr9755hOwkOF8wazSSFmQFz6lkbFCpTz5FN3e6RlfkuUOzvZ6i8CHerXIFvV6XMTfh9RL4JT8a0bkEIrdg93u-mTIpwD9fqYEnrP1RLXVnzINnx34NWp-y0gBG2sKfrhHKrsaG1y61iiHM68MOQZ3KiZPQ9QgkPnr5hAetmYxrHfR5tW2VsaZDOyg9c4h7iuwrsVZCTSFobesI-G3BGgNMoZcKI3v8LFdRul07jzxU0rdyZSxrgky-1YWZPG6_0hM4lMZa2JZfHrgAvYwAooxf_c2yLVLX3y0RZxQrwTBwmiDdHoPQ-NzhTY2BgFTWMOJsVJLrWWf930qCpfEmxSSSxwwK0vitwMDMSx59SYxs46qZIxOsYumiDRYg==",
      "menu_item_list": []
    },
    {
      "name": "Kitchen Supplies",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-srsMoIx7NaaLKc5FQLrRtKBZcS7xHU-SwaMIggakSG8m8C-QkFZ47HnDqIeN5Yo_OOWuJSNLTwPRBRNbNvl2-WZkwbjCl3cIslysq0whxvhh8gqeEiqFV5daaXZ6gzME2lEdAcGVUiDin-e0TiJuH41fxcxKd8U6Gu8APyaeo4GHzafct8yuNOG1xZrltKVP_aHBJdve2pgWPUQHP9vYCWZeIwj7IM6l1h2pb0fIsPjrPz5ehZrm66NNu_YxNKi5G7NsyeBlVAVA1EMuafdjeHGRMDMlPOKff1WYtR5p7G_RKKMOW2o-FoWq5C6HO80yaI7Q7xsW7z0o3vqapkriozcfTKp8uVwvjXQRFwZE3KaIaLaOm8jo7-eqcZO8TbRiSpS5EEDfFUWRxjUN3_F1GW5FNm5SU2usXHHUAInoAjhWRv2-3iYtl55uGDO3doOLO6oLamGvEZgw2k_dPJULAW95I4esYVhw5GKF57b3ElKG_fkivVRhvHLAe1lYdW7iw==",
      "menu_item_list": []
    },
    {
      "name": "Floral",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-t4Emw1-ZoACHWFTuSSQmsEXWHF97YaVXrWGtlQDeH4FuSXoH2CwMMSdjQ1Ch-hXsL9m_-SVItPbfVLKvy4tdEEuEjH8ETz3JDMHWo0PWBGBLxKEFkXZwy0wPvth1YrYgwPr7sGtH8S8IhweztfuoVsLxVW1MWoroDoD0oMiHuzZIYGMTmtvggoduxdaZTyrroflisNs9xETFIaFmjkMTbTprnCBs3LWCV2EJpr6vnL0gFHY51Y5X2gwm6IcJekYIUx4SUKkX5iZWIfpHxnClchdLS4CFWFO4JZkXeZNY1olAinDRA7PTG9pbZEmxW7n_KSEGu2ATinBpI9f8oYOOwOwHMcSz1MQj75_ZDgkglZ3AJtLyGnq7fENqcZgs5piZnToUvYf9HCtL919JzsRSoA9KvXUft-DI4KIa00JX_xac6ww7EeOTytR_YoZvbteuvNUCiF3Ku2pLzxTUjWcmjY6bOBj-d0-MRA95dP_lxKE",
      "menu_item_list": []
    },
    {
      "name": "Party & Gift Supplies",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-rBDKun5cc87WwLfMI-jblytbmVj1O7OB_ISF2vvc7yzJtH88BaMWp5h91hsv5H5H19JiaOVwRB_z-y4AzuR4L-wk5V6mWtJDQoDUG7GLkB5Wm9JASXidoPBAjDdwyf7vZ5mDeneqW9z4-VUn7pyWdTKULbtReCvkymYzPOr3NwhgW4rQ7MRFD0G3f4UHWuNv84uQlNFHCz5nyfgbWbGRYf43-4UselGzQg6U-EYZnq68G_LL8Sxd1VBl_l_TdbC3Lzat9nElaRpedNxN-aFtcUR5rTehKmd5px1akCHiddde_SPFGNUKvNnQtVe9JSMEfaUwh7jt9spO8lkzT-sOoUXu8cK-ruNki9m1PK4ZGVLldmbt1NP8PBwda8nMLnSc981Em_OyYLYsC-WhuvX5hde1iP5e09z2oJM1-kBQpYg0LKXbPsycbX12q4-GbNm0QaxLnBG6CBvrZtmzdoybCDNd0tFZZ09JlGbxOTsj-HuqUMan4_PuFLWhFHFHAOrbA==",
      "menu_item_list": []
    },
    {
      "name": "Pets",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-jn0pTTCqQ6vikqB29460S-KtDi4WE_p5EdB-vKgoSIpjNBwewvN8-ZtYLespr1e25gItN3nuyT8dDwhmk7F9yGXQLccNgIDXvHdTz6N2HiwsFYZ3uACb2hBEPZ23kbNz1q370sIY4RgulKiT0JS2Uv0j-fa6RKg0GwWF6heI0lQeHtkHwx7v8npvMYqs-yns_oWnUrZTPyDA3wVECnzAV85kgGQ8ZO48cxwwN0vAtWJxrPFUwW0ce-R3J_WMtu-6_3b8Wbs7b0Z2u01V9iysfBhG-GTsVIyqJWkaDuabuPXfq2sVqZg3_PI3tdnsSWB9skl-eAdW2qSS3gYV6pa3LQtfefeNI5-oek7Dum3nszpLoZez7-_-Whez4qKKoeq4Ex8YXA1wp14575PTt9Tp2-kNNdsantdN3XNw6qsrz88KiBDphHkjwlwFRi5TmlZV4_k4GVESWG_SlfobuWbbChqV-DJ9jfKZzLa72Anw3Ut",
      "menu_item_list": []
    }
  ]
}

📘

  • As seen in the example response above, note that the initial request to the Get Inventory API will only return the top-level categories for a grocery store. Next we'll demonstrate how to retrieve the next level of categories.

Visual Response

To fetch the next-level of categories for any of the top-level categories, a subcategory_id must be provided to a subsequent request to the Get Inventory API. Here's an example request that demonstrates retrieving the subcategories of the category Produce from the example response above, using its subcategory_id.

Example Request & Response

curl --request GET \
     --url 'https://api.mealme.ai/details/inventory?store_id=3c7fdf9f-9547-4fb8-bac0-8ec670c67622&subcategory_id=gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-oUKixAk362zkFMa_F2sD7yNmTDCz9P7M9I6JkNqtHQFRbWyCmOLOa1VokEsDrYbOR2ZyY3GEYGSKEe_eStIRyIM07mBEKHSuyMfi0ZP3eP2O7gTazOVvt8RNdbmnIX7Oh5Y3ATuIgP3fSPBDhDXoVnvQwzEJHuXFgcCFBGMh31oRNPMpkoYZJn5J9qBVfpJobDAEYuBQLIy49FIBKoAmlGYwJLUgUbR4wBj7op3QLxVSoQrzfXLq1mNa-0bafmth1i7BvjgXsV8z3SF6D6tjpPxTrFMFMeCC6bag-kVtXj2A7In5nYTboV3EJ-92LG57oO_efLZVEcWfOkZlkOTXOMLmLcMr13zMxg6MnSPEes8Tk4oyoLm5cuioidI42zka3I6buYUfIqtSgUzr0tiM6qAR6VgtlMATe2wgTw8V3QkuuyV9pYmkz9d9xzY3Gm1Rg47ftXpK0H0dgfn6vRdBAgnnnjBWozQeggOed9Y2Vc1&pickup=false&quote_preference=first_available&user_latitude=37.7786357&user_longitude=-122.3918135&user_street_num=188&user_street_name=King%20Street&user_city=San%20Francisco&user_state=CA&user_zipcode=94107&user_country=US' \
     --header 'Id-Token: <API KEY>' \
     --header 'accept: application/json'
{
  "menu_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-l24QwGIBjrsjbBYibaHJtZULBdF_oogtAg3JN11w_V3bXQYMRXKNwdwGJVEWGATlGCv1C_Duv4DZV7fC6iw5ss3Aco0KC_sBY6rTphpIZ6Kfzxxv9Fz-2TaAdNrm8CbJC5XEtVMlAq15wbz0hZTJvHvW_V74BmpMcHYucVIrjo1Wx7m6fnLgC8wqtpJW6r7eKe0YyE0-13CWkN4NChETzUXO1hQjQF7kiI3bcikqDUOkDx7RQ0wdtrNDQxAzYBIOc6dkhCtn4rEVuWpF6uxNEI=",
  "categories": [
    {
      "name": "Fresh Fruits",
      "menu_item_list": [],
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-oUKixAk362zkFMa_F2sD7xe6uGAvpCMCrfzaf-AhOdbfp8XgvgCFCN0YZWPzkL4R0GMi2CvSlDJQlfHIoXndYVfSH1fhWyaq6mt9LYaMTOjN1cm2Ebp88ZIN3RGuFH1nHvKn1Rx3VarJ_Cg8Xk53xrO4Ypw0hxncWbIZF_6o84BBfK3fuQ33ykHgWM6jEqjFgUAx_OLPkhPg96RpYMuAWpr7XWHAHKlyBqrVfI_xxTAJgq0OFVD_u_Z90YuPxl3q77hY2xiKUu5gGrIDRdVA5wVY8rLaO4i_jCztQ2BpqyfPBPpJeUSmqGqwRBNFYvZbhcGb75B0HXrj6asftuxA--fk2bI0LTjRITeiAjNNSH-AXZ206xaQ4zs1cltSJny1vSx2QpB5ixyrsYAhKZvCx46HqEnUGM3uQ1_piAWJaspDHxqoqQK3gsuHHiKNxlZe2QqLiTDDKN_f75y2WzSuQKPF3Dt10h6ZJgh5Ycmcy4BRQUCOyZLQdc5j9g-iF0492YbD95jMsRuamwnrN2Uidc="
    },
    {
      "name": "Fresh Vegetables",
      "menu_item_list": [],
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-oUKixAk362zkFMa_F2sD7xxr5qSwQyYbIr11le4Kzb6eeb-_mQxEYvUNNAy-2dI06OVjvW_EJznWg7DoOcN0AUFwaegq7E1rZzspIB5N5RRMwIWD0FQrgPSMWmr5PFY2Jk5_luLFh50k_Giqm9taIKcU9Ef0H8XojZTO-tjWtDSIWEyzCOJ0b6ZAvWz91ONeFYOirC_W4Q81couBgxHRuWAKt64-NJ8mGltDap8eynzJxcAmxTuZi_tniQ-b1U8TZcj8D9N_-kZJ_Ea5Uj9zH257CqvqshQeU1BRz8Vr8ugjyxaMNRbC15yU8qXNr1ZN-rK6WVEcZ7F3smAGeDqhakyH0t50zJVyKqleeMy6gCRKpOMywZDQ8SJ7hnkTnYbq1knI6A-SawWnt_jbRT76avKr0gD0YCvrgKzRFyqlxxc_UQAjH6YLiAKEZQN_-Weovp5QQjdRp6ufdQgtAIQwah_aRQiz2j9jyO-2RiENFyYJ2HzsXAxmEe072vEzSa3fch211xokn0L3TNlKNTyj-w="
    },
    {
      "name": "Herbs",
      "menu_item_list": [],
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-oUKixAk362zkFMa_F2sD7x3vaCIz-dVDCz3VUVduH-iw2fbRMgnoR3KtZqlLIN-D0PXhrxHJgWl8lAI_mxNK9-JyojVc394ZVHbtoJrUTIPy55XKhKxxeh0T9d_1Dw0reZXrxjZH8n0MU4OxPQ2IMGllgzr0oEqhH68roXMYA7K4wLw1r8MxabDR8KCIqfqq2Kc-yBS90AQsTPPu0ybGaMeES4JNfor9dimwjUQdXsk87jIOWH6tvMMQHFqy1EiVl0eOsmUoxkuDxtIEgVZrLQbz8D1R7zh5Dj2U4FLZcoeOWsO5dsyp5VJC5yuetDIVh6KOW-ueegx2Ltw_EFJNkGSgoRDUWTD2XpEGj2L49VGIPy8Powa8R90qTxsvv4pfkavRVTwBNPLm_y5OP-aOAC2bTzZZiluzt_rRcnd2haXXnB2ohfSYtCh-f7x9BKwA5wJjWGR1_M4gVb6EID76j_0s3-1CtEdjPpFR96pH30MUPeoL7pirq41oHPRW0DtQQ=="
    }
  ]
}

Visual Response

Here's an example request that demonstrates retrieving the products of the subcategory Fresh Fruits from the example response above, using its subcategory_id.

Example Request & Response

curl --request GET \
     --url 'https://api.mealme.ai/details/inventory?store_id=3c7fdf9f-9547-4fb8-bac0-8ec670c67622&subcategory_id=gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-oUKixAk362zkFMa_F2sD7xe6uGAvpCMCrfzaf-AhOdbfp8XgvgCFCN0YZWPzkL4R0GMi2CvSlDJQlfHIoXndYVfSH1fhWyaq6mt9LYaMTOjN1cm2Ebp88ZIN3RGuFH1nHvKn1Rx3VarJ_Cg8Xk53xrO4Ypw0hxncWbIZF_6o84BBfK3fuQ33ykHgWM6jEqjFgUAx_OLPkhPg96RpYMuAWpr7XWHAHKlyBqrVfI_xxTAJgq0OFVD_u_Z90YuPxl3q77hY2xiKUu5gGrIDRdVA5wVY8rLaO4i_jCztQ2BpqyfPBPpJeUSmqGqwRBNFYvZbhcGb75B0HXrj6asftuxA--fk2bI0LTjRITeiAjNNSH-AXZ206xaQ4zs1cltSJny1vSx2QpB5ixyrsYAhKZvCx46HqEnUGM3uQ1_piAWJaspDHxqoqQK3gsuHHiKNxlZe2QqLiTDDKN_f75y2WzSuQKPF3Dt10h6ZJgh5Ycmcy4BRQUCOyZLQdc5j9g-iF0492YbD95jMsRuamwnrN2Uidc=&pickup=false&quote_preference=first_available&user_latitude=37.7786357&user_longitude=-122.3918135&user_street_num=188&user_street_name=King%20Street&user_city=San%20Francisco&user_state=CA&user_zipcode=94107&user_country=US' \
     --header 'Id-Token: <API KEY>' \
     --header 'accept: application/json'
{
  "menu_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-l24QwGIBjrsjbBYibaHJtZULBdF_oogtAg3JN11w_V3bXQYMRXKNwdwGJVEWGATlGCv1C_Duv4DZV7fC6iw5ss3Aco0KC_sBY6rTphpIZ6Kfzxxv9Fz-2TaAdNrm8CbJC5XEtVMlAq15wbz0hZTJvHvW_V74BmpMcHYucVIrjo1Wx7m6fnLgC8wqtpJW6r7eKe0YyE0-13CWkN4NChETzUXO1hQjQF7kiI3bcikqDUOkDx7RQ0wdtrNDQxAzYBIOc6dkhCtn4rEVuWpF6uxNEI=",
  "categories": [
    {
      "name": "Fresh Fruits",
      "menu_item_list": [
                {
          "name": "Banana",
          "price": 50,
          "qty_available": null,
          "unit_size": 1,
          "unit_of_measurement": "lb",
          "description": "",
          "original_price": 45,
          "image": "https://d2lnr5mha7bycj.cloudfront.net/product-image/file/large_660f23f5-11f9-4e5d-9b64-7e69348ade1a.jpg",
          "customizations": [],
          "min_price": 50,
          "formatted_price": "$0.50",
          "product_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-huZA-Zo6jkjMqj7zJti7N3rFhQQZVYPc-2XSWHazkhR_v27SWwARujk7QNCKLuvy5tRcuEAUeLIlFWrpB77v4SRxj3IHJ3cw1nDI4tenUq23ozeTSVKdin-VYL7kDcKqSL5fxKZZ11CXa404Pb6aWIGeTaqCqWl_3q5PUQTUejIhi1qrVndTpyP3bNgzqobrRSKX-VxBjMeyeb8AvXkO7JcROj1brk3hPokb0QuuanWea0Zenf3YW5rbgypTzCILzjn87FhcsYcdPRxbRQbe7tGxKcWddcScZc2mgzewkt-wpOMidoQL48BbN6SqxNghn3bwEzTG5Uie633Wjdo0rPIdb3NCODOF9szuTTfRxCoNWWf_5NxMZhCYfv_LqBh8Am9MU1UDgyH7IvqX4h1QJBe3E_W4wAUWSLQgEXLZ8YwFY0PNP7l3HkwjYrCcHQnWBvujR1a6buFOIjfeCd7d-wxX-yzFzWS_8hjgidbK64HXI7JG8O3mipKkruUGDZIb9Xnf-Ht2quI3NL5Z3VpponBkNopm5Q92rWSyXm12Lc1mYgJCW5z285AYcth9cMTxqKQB-LaogFUdRwA85xeAo2oBFu6mOPi7xf5AQo1zdzHZciYnM4C_3y5c-t0B2HWfETilkB-7yqrrzVA5Tfs3ksp4pNkMavC6Pda88Qs2MwPy5XecJdtFBtXdtTsdWKUW2KaeM9ncbcZncrhoxsDRfKeqmnyi1TgGyHXQz8I95gFga7nE0egMDL0q6GlYt6RsGF8LpDMnaeKnedipDDQlao4Z2TGo0dx11Ca-ejp2aLbhEhs8CSgKfQKeFbmJYI6rN2ppxCEOf8ZLpn76Iih9NyR4G5d-QlpG7MHowkooFUP_Z88taMs3tV6WhffJJfu7GM8fult7xk2wWccyykc2PMY20evBjdjWzsYcfgVG-kCFIWFa2G4Ezk07pq5mkBoQSQMuxA_WaSUA5142-PXkYMwzw_1DJzEqPKtO53lt_9QrCp1fBAoAsruy6T298F9IIS3iH2hXsGF5I-Im2u1rtZVh6YgqBqxCKHXlrPDwdN1HDeKhJmD7trQ4y2vRLZuOPcZgyY_LVnUjJ7ASIwe_E5QF3BL65e97va3G4wza4jPMVVEQN-ksVpf5LD_cjnD-EzJFbgV3ua17rbd-hrLu9R4dC-Ey6zMjMJHqJU3-_h2BBN112SIBS8ncjdwE-DcUCMNR-ZP30CsvEhPADdxNyxn1LV1r-iAR8UuO3bFQGfs-mPKcheM2e_lBaLIDTD_ulxIGcoWBqcO989cd0ogjK6kQBbShM4BtMzAT73yIyma",
          "thumbnail_image": "https://cdn-img.mealme.ai/9d1bd9c343de00623180950c7f7de1f03ada5317/68747470733a2f2f7777772e696e737461636172742e636f6d2f696d6167652d7365727665722f333030782f64326c6e72356d6861376279636a2e636c6f756466726f6e742e6e65742f70726f647563742d696d6167652f66696c652f6c617267655f36363066323366352d313166392d346535642d396236342d3765363933343861646531612e6a7067",
          "should_fetch_customizations": false,
          "supports_image_scaling": false
        },
        {
          "name": "Driscoll's Strawberries",
          "price": 640,
          "qty_available": null,
          "unit_size": 16,
          "unit_of_measurement": "oz",
          "description": "",
          "original_price": 579,
          "image": "https://d2lnr5mha7bycj.cloudfront.net/product-image/file/large_d60e0c89-74bf-446f-8092-9f5fb3644561.jpg",
          "customizations": [],
          "min_price": 640,
          "formatted_price": "$6.40",
          "product_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-tDcVJg478qsIM6W-3LCjSmaTXP7RlN91dz4XZzsj3uR5OeQyfE-GbiRYbnHdCXqGLnZRP3rOw46TBELjNqbMmSXUcfFH-U4W3Sn29pZyT4fV1g26VpfvjPNmP0cxGnYW_wM54bAS7dl8WaMrGXoXP1Abfgo4AblOAglqZBbY6F87YECMBMkehKXraty-oSJoABhDbG4XQydaHsv2JSY3Jr4TwbnPkalWuSiLMFOuV1vLoGOsHxP8pclX7EjHEtyygkWqGHniPBoUXF9hkBg70o4mPX2DWi2y70AnH6gs8AQepRjoez0d08pA0Li8EY2G_BGAMobJUN1lwEYA2M9Yrk6oh5nrXJdwUMDmXj1GXoA93PzeHadYNLo8kMh84wmiAqWUpYDL0rwo9WYrs_OBFzcHsaqXjzM0v8M8qwDL0RzqdO8fOVeCQ9SaG__EbXGHA8nDU58Gp7X2dphTjvT5EGKe1aMF1RHvS7khtZLypVOtuQUxUunJQha1vIY87-HVqhpXp1L6B6PVxZE4fz5soE7vpYfQ1oXnZODrsqhZ-5kIf8CY5ChLpMFVXJRh-SPHg7d0-hw8N-NnvdzQs0dBSl_3KEIvUh16chcD0z2ofeunjXtjjvD7LLL9ubvt1t4Rou5pSwLiAx5x15JkmDgevRDlGakEy4eJz0uaB6tYDt9WtQTceCWZpvVsXpTVnuXWNGED6kwNddTaJZOvnDSidsci79dIuW3jKO3FzbArF7tRkKvnUIpW7HGfx2rHPnHinv_upvMWQFEb9EcoJeCAHLzcd_U8viTOKP4XtnkaUBlvZfYzoy7yAqY2RgB1dzhQVkYJGCBveXmXqEWiIidIkHLa_J6XocqnlsKwRQ6PePNFtYhrfL0UY6ZThcKv5YzmEvd3BiE-w9z0RdaFsiOrBjWGtQ22YDXqgyszcz-83BH8VrA42nM26zxtlC-oqXu0uaKwoFbmArvhCgmzTQw5KlJThlxpg7ju8ZSRKrgQ0Akc6P1plB8gFFLuneBRZbk5dxFFnxUB4mnirNdyOcYjpfhb-YFM0HsUJjyTYpxSiftko6HIWRzS4J3n4N1Gr6dkzpiTmzDQcwbJuMJKzdBVc11HCPOnrbngIGJHbB-a8hxvSM4WuFlDKkwsAzT9p8wyMfGZred7chXnL0BTWnBwy57C20STdv39HbuHkleZ-U92_iGD5Z4HUureLWrLNu_LyQeIVwKpTiimbhgEKbnAvK6F7QPPleXqxYdPnVe3wMeXnC1FbW0DVHV7E_8q9BPSuq6W9Nwot3MLQyK7n1tYBY31QmYl7mFNfbEgyi6pZ7ZHcgfsGXrMg9tfkONXJqHAJUWTcwH2AjXlGqAbvpogHo=",
          "thumbnail_image": "https://cdn-img.mealme.ai/35b49f6ec11fff359d1a2df09d33f80ab96cb561/68747470733a2f2f7777772e696e737461636172742e636f6d2f696d6167652d7365727665722f333030782f64326c6e72356d6861376279636a2e636c6f756466726f6e742e6e65742f70726f647563742d696d6167652f66696c652f6c617267655f64363065306338392d373462662d343436662d383039322d3966356662333634343536312e6a7067",
          "should_fetch_customizations": false,
          "supports_image_scaling": false
        },
        {
          "name": "Hass Avocado",
          "price": 200,
          "qty_available": null,
          "unit_size": 1,
          "unit_of_measurement": "ct",
          "description": "",
          "original_price": 179,
          "image": "https://d2lnr5mha7bycj.cloudfront.net/product-image/file/large_09ff3801-efef-43e6-a14b-6dc55a3fe4c8.jpg",
          "customizations": [],
          "min_price": 200,
          "formatted_price": "$2.00",
          "product_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-nIgFPJJqdJfkd7KgeRhGebojQGEWNxAN6Y9_0rTDii-5LPx7pQG8C6nSvAuWc0kLmVvN2BEyNbfnD15S4DLmNve28rahU5B_hwi35xW3YpXd3MESSUT9ScXONkXTXJ2bvwwpBGu2UAxZVP4s-uhtzh_RJOkMNt6sMmoebtJ58kqHHBjORWXM9zKig6Kro0Rg3xtTWzf9KJNjzRyZ1GG6kHRJ6gUsqLoVGmfyVjZxL-UpVCH5l27VTqj8muyL-1_IpLvaob-0nUpE-IhewD2y50_Za4mgU2MU25d-59ZAjP8zSEfWqwLPGKnE1ToWisY9ybTsl6FjxvHDlnENk_Soq1aYse0NZwlwZo-ZbBPhLgAyADhf5i0eSwHTPLjVPlPmWPM6IsbkgXd86KA7c6i9Op_YBY0ihwwf1l0UjQrZ7CjYv4-ACaA8AqOBDHZGE1tY9WrpjeXGn7lClN4P53Sv4GvzTKZxfE7kQCJ3cpic8Mg1pLOb6ow_uKdZ6hnAZFGmO0X0LixrXYtruVtwLype9HzwpufiuOE8kg4OYBFqFmwT3kPYWw_ZUPKKYVPiMUAn6rV7OnmquWxDPvs6jemlUF1p1P26XwTGw8YbzuE4Dc2uLRuj0gXfIvSfFiRgZ3_bY8gdzoo5u-1uy3_PC1hj3fx4brvxU3XFpFE2BF0VT6hoPszzR2GqMKbxdp5JUTwS4q_XeR02zKGitQmGww40QdCiEwg6_Tvr5szT8MDpbxfwG2Zk5mdinlA2PMgeildbxKarHlzJJ8bgpb4_dBmm4JoA3nTuvvyPN_-_PAlrNTet1nORoJncaDmS-plvFEsWzSqUnUzRg6DMPeV0zRg6-wVFajP_XiE73SMXnsalAVfraVkgXCbrPqg-wcm_0bgB8b_VIcpuDJrQMFe9WNHgoHpBp_r5xSP_1-N9sOJgWkEDqkChdWv_6q7a4zwspn01BnACqR3WFrJ2t0salB0qO7l1wP4nlkPzS7io27KK3JLjn4KoiUa0fu0-hQBrmYn_Z5CMWRcK5MZFbSqkJ3BYCMDJmFNK-pwemuqW_rsqbA-0bqafG6VbawN4g_hjm42anuMQ-ZGcG_zlGETvckgQ9tZMckd3PmZdlHY7Yjw0anm3iXYYGKE3Xpt7QEzuZGaY447p6X5kfEpKfTCMtZgNkJFA5mqLIkRjUd4RtQhNFv78EyWriWeTjO27yr5Qp0bGNr3r9X2yF469e7hlLDpIHfeTPSpNAzajwFOcQ2a6KlTDkTDR83vXemLohGmMfVqqRMCwJWpqPvX95dQ1yLOF60tLFZxLs3YqfMwP31rf6oinNHYE9Uuzud_nGbDnnIVyw==",
          "thumbnail_image": "https://cdn-img.mealme.ai/1258a87488f2316a058cb2b81bb7352662c6ac09/68747470733a2f2f7777772e696e737461636172742e636f6d2f696d6167652d7365727665722f333030782f64326c6e72356d6861376279636a2e636c6f756466726f6e742e6e65742f70726f647563742d696d6167652f66696c652f6c617267655f30396666333830312d656665662d343365362d613134622d3664633535613366653463382e6a7067",
          "should_fetch_customizations": false,
          "supports_image_scaling": false
        },
        .
        .
        .
      ]
    }
  ]
}

📘

  • Note that Fresh Fruits doesn't have any subcategories, so the Get Inventory API returned a list products instead of a list of subcategories. However, if there were several more levels of subcategories beyond Fresh Fruits, then those can be retrieved by passing their respective subcategory_id with each request.

Visual Response

Quote

The Store Search API, Product Search API, and Cart Search API all determine a store's open status by looking at the delivery or pickup open hours provided by the store. However, open hours aren't always accurate, since a store could randomly turn off online ordering temporarily during its open hours. To check whether a store is currently accepting online orders, the query parameter include_quote must be set to true when making a request to the Get Inventory API.

Delivery

Here's an example Get Inventory API request that demonstrates retrieving the delivery inventory and quote for a McDonald's store using its store_id: 3aee32bf-581a-47ea-a810-8c0ed90073c0.

curl --location 'https://api.mealme.ai/details/inventory?store_id=3aee32bf-581a-47ea-a810-8c0ed90073c0&pickup=false&quote_preference=first_available&user_latitude=37.7786357&user_longitude=-122.3918135&user_street_num=188&user_street_name=King%252520Street&user_city=San%252520Francisco&user_state=CA&user_zipcode=94107&user_country=US&include_quote=true' \
--header 'Id-Token: <API KEY>' \
--header 'accept: application/json'
{
  "quote": {
    "time_estimate": {
      "minimum": 20,
      "maximum": 35,
      "scheduled": [
                {
          "id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-h0RTIpwePfNbdt5gIdjpyxbOj4P-RJrqJ90_W27elVkBoE_Nrw725nJcf3VqMYqhlhi9Ga5y-DFgoxFSYMfZbdAa4y8VuYJSd3gWr78EHp2keVVYbiCisAiSWdUIslq9g==",
          "minimum": 1681069538.4933856,
          "maximum": 1681070438.4933856,
          "delivery_fee": {
            "delivery_fee_flat": 199,
            "delivery_fee_percent": 0.0,
            "delivery_fee_taxable": true
          }
        },
        {
          "id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-h0RTIpwePfNbdt5gIdjpywmvyABKIoO28bIIK9xElZSNC0AQzrMAibjCegkC6S_HaStH_znX2qjuHXzPOp7OnsVW_Mfu7GsqDBqW3z37irTtUaibCLdijklmb5bkAjVdw==",
          "minimum": 1681072200.0,
          "maximum": 1681074000.0,
          "delivery_fee": {
            "delivery_fee_flat": 199,
            "delivery_fee_percent": 0.0,
            "delivery_fee_taxable": true
          }
        },
        .
        .
        .
      ]
    },
    "sales_tax_percent": 8.82,
    "order_minimum": 0,
    "delivery_fee": {
      "delivery_fee_flat": 299,
      "delivery_fee_percent": 0.0,
      "delivery_fee_taxable": false,
      "threshold_fees": []
    },
    "service_fee": {
      "service_fee_flat": 345,
      "service_fee_percent": 20.0,
      "service_fee_min": 286,
      "service_fee_max": 900,
      "service_fee_taxable": false
    },
    "small_order_fee": {
      "minimum_order_value": 0,
      "small_order_fee_flat": 0,
      "small_order_fee_percent": 0.0
    },
    "asap_available": true,
    "address": {
      "street_num": "441",
      "street_name": "Sutter St",
      "city": "San Francisco",
      "zipcode": "94108",
      "state": "CA",
      "country": "US"
    },
    "first_party_quote": false,
    "third_party_quote": true,
    "courier_quote": false
  },
  "menu_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-ljHomlt4LQTZiHA4K8CDIfv9scKD8TrrYeOz-mV9jonTor9Io4SXLocoAI1GwQTSalksXI7m20hfJX15r-9vXNPJrOL-qBUojlL3MCoqcZDaranYVYIVNOCnnYsU66sruSTSLEDWILkgwm4-aJQs3fx4CFyhljjwA3RzpVKcQzF0IjgxUcGjPFHWxjeU6ZiEDCUVFK9RJshsnSSNQOGEeW7TWdHMPeSn4YQotbfIsheBNxmJXg3D4I0r7tcM9wJsP_w5dvCmaynZkD0kx53PLTSTVO1R1yuOe_tZd7n224v6tVW-hCuF09VxzWiedgGwl1kBlv3IIqI7J3p-LqWrHdlj1pMZO_0UNKMwk5j-5kBGm0VC6X4iptFpQVBzwwu3Q==",
  "categories": [
    {
      "name": "Fries",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-rZBg3ffsaj2CqiiamkdMdfPlU_CawDqRH5ayNToKQO04jnZWJStZTdKZllIqO-bgLdI7uq-jw_8hq5qqNc6v2q1TKnTMSZbNjee7ujgr0pWaDSfpz7TEmcWOLkE30ncng==",
      "menu_item_list": [
        {
          "name": "Medium French Fries",
          "price": 600,
          "qty_available": null,
          "unit_size": null,
          "unit_of_measurement": "",
          "description": "",
          "image": "https://cdn-img.mealme.ai/8fccb566f0eec794a6d1a00dfa3b601948c69a2a/68747470733a2f2f74622d7374617469632e756265722e636f6d2f70726f642f696d6167652d70726f632f70726f6365737365645f696d616765732f64623363363936366165356634326538353735393833333163323232643432352f38353962616666316437363034326134356533313964316465383061656337612e6a706567",
          "min_price": 600,
          "original_price": 600,
          "formatted_price": "$6.00",
          "product_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-lqRsEKOp-2ohuAwFA0z8HiPRt1utjYGgEEqvrUOkvCmwZFvJUAHxrsV3fta6F9ZuOVNMy7lVvCFBUGCDEJVFP2fiEPuMhpH5vOBMoyTff0E1gz8oBnZ5T3Z2VK6-x81USFxQF5QDwwhAfY8j-lU30ZG4PHjwbGS9B6WPY1Xnz8q1cUg77yKv_dKc74V2LbUxyFBzOsL8hDSrXHgaOUhvOdDRAl9xPQKylz5gKWAryx9jsVKXPVOuZ3Ys4r_yt2dqEvilfnG3HLsmIDA2IH5s4LoJJfLC_9jKAAIaSnbmoFcQF47n1GOeV7rLxocM0eKrqb9T-XxZCiO0W9hGDxLiT7Tof3x3uZog8719m0ccb24Rg8Gfv0Eceh85fFOZ-n9MDawuDgP_VqIDW1eB8UozmyU1cn_AySrvExuhqJH8HF_aPF_xmf9B7opeHSpyxvOrKnEGLVE5RcPC5IGBFYQePlq0NuDzBvWC8kiioSZo6u3tdpXkYJUmjC-f0KHBaBOkN2bIJQn3ZgWnhUpDju-ua1zfzst9lrzyr9F0uM6fya6Zx-sGueLWHZYjPJfCCN31X8r40ziJzaRRN5c2J6300PiufeFUEcRzQZGtRVEDYg-P7Ta20IutzgFmjLIdZlqsXuNA06H1FyZZ8Mgy5ttIJam8e96ssUo4Na_X9NRlZLy-eP_sasrvZ_8bUwWxSxjSkcR3QoFYJ9SqYiC2PxV_MxvWvrauNPRTK3TJZyQWNp5KYqCjCyR36HxNLVhSoEzyMe5bqDP1w4bEpFwEHy0otGdZicEvkYoBMKj73bsZ-FYuRnLNuSh_EnuO-9QiM2WBIS7jQKR3Xvy8Fost9NIOUs=",
          "thumbnail_image": "https://cdn-img.mealme.ai/18ef4cc6b8a9f63c1fa96bf48c3c2b7ae0ce4b9e/68747470733a2f2f636e2d67656f312e756265722e636f6d2f696d6167652d70726f632f726573697a652f656174732f666f726d61743d776562702f77696474683d3234302f6865696768743d3139322f7175616c6974793d37302f7372636236343d6148523063484d364c7939305969317a6447463061574d7564574a6c6369356a6232307663484a765a4339706257466e5a533177636d396a4c33427962324e6c63334e6c5a4639706257466e5a584d765a47497a597a59354e6a5a685a54566d4e444a6c4f4455334e546b344d7a4d78597a49794d6d51304d6a55764f445535596d466d5a6a466b4e7a59774e444a684e44566c4d7a45355a44466b5a5467775957566a4e324575616e426c5a773d3d",
          "should_fetch_customizations": true,
          "supports_image_scaling": false
        },
        .
        .
        .
      ]
    },
    {
      "name": "Most Popular",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-vpO32bZxe_tYR7JMMehj2VbLdOjVh9hiHQPhmksu7mhPdQ8pNUBKsOEDOCAuwXXkDO2Ir37KqmUh_CuY4Na9LcGsEb_mAyYB2TvEtbuzAo5AUHtmD1f6-kPywxgrsenRA==",
      "menu_item_list": [
        {
          "name": "Big Mac Meal",
          "price": 1510,
          "qty_available": null,
          "unit_size": null,
          "unit_of_measurement": "",
          "description": "",
          "image": "https://cdn-img.mealme.ai/56644401375dd52f55d6cadfa2c6d9beeac0e1d2/68747470733a2f2f74622d7374617469632e756265722e636f6d2f70726f642f696d6167652d70726f632f70726f6365737365645f696d616765732f62396562313962313937323763626561346465333130613932333734653232322f38353962616666316437363034326134356533313964316465383061656337612e6a706567",
          "min_price": 1510,
          "original_price": 1510,
          "formatted_price": "$15.10",
          "product_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-laLnSozBl_UaEIk-B0XFfbE3g3nT8c4XeaSp9aF7z826yr4fFL4_BLNzF6YSDeOhQ67A4WDq6Egy4xCXc-B2iuBXJMNJ1p-BzON1f5b5bUbSXqXXziSslrQBmoakqL5PZcszcqHnZKE8mp1B9eda0diMDyCvV57bcHNc40Jofd84uTgyWy0m8aOf09ulbdHlx7-j_Srvsf_Rdtk2gykKAdRFYOpbyOZuPAVnvL6Kxv8SQ7nTTaAAV2EQwWe4FTaKnWHiXKZ-2OTgxwnO4B9BCzQ-wvRuHDyuJiHrNaAzuWGgvMfUUvK_PQzlNcw8W6a2TxlpvuL1MEAudbs6MrHx-Gpxsf1i7RxGFS2B7RBGUMzWMlRON1wtUjcpXU4_iCKvyBRbSGL0WERKlIkWoN9zvMh3w1r36ofCsfGMH6xWO2B8REzXPd_FiuPMQod5IpLOKH-ue9qgLOvksPmtd6NO55eyb1jnz4DA0rkdfsHEVtPKSTRKEJHsg3tiFsPKYlAVo7gdQuiiPesviz0DXZzoAcvFC42TTVtwKuHCDAWUs_hTPOqcmU_wfkcdcEbBDGCXh2KAvCxycSudwt4lHZTxvI-PBXBIRx2PYze1v5_Vkz1UAjk2qrDMrUKGgbC85iidCO1L3TYpzzndqx7Cui0bZnoGQ2CByaBXEC2ozAcdz_dwdGUa6t-qr2HW_BcpoF9BrdK9sZr5mXP5c4wli1FXlUjYn4mCGxEVxIswDtb4esiqF0f0JOcWf7zSJ9acb8O8mrHbzSqawV--V8ho-A8qK4N7cTS1I7Y-Ey-PGf8n37jebvfGc9eI_SZKgN6tItc_2VJfr9v8oIHvJ4xgKZpQ8w=",
          "thumbnail_image": "https://cdn-img.mealme.ai/5afda5dbf78f6ea6e83f23f334a8b560f1346de6/68747470733a2f2f636e2d67656f312e756265722e636f6d2f696d6167652d70726f632f726573697a652f656174732f666f726d61743d776562702f77696474683d3234302f6865696768743d3139322f7175616c6974793d37302f7372636236343d6148523063484d364c7939305969317a6447463061574d7564574a6c6369356a6232307663484a765a4339706257466e5a533177636d396a4c33427962324e6c63334e6c5a4639706257466e5a584d76596a6c6c596a4535596a45354e7a493359324a6c5954526b5a544d784d4745354d6a4d334e4755794d6a49764f445535596d466d5a6a466b4e7a59774e444a684e44566c4d7a45355a44466b5a5467775957566a4e324575616e426c5a773d3d",
          "should_fetch_customizations": true,
          "supports_image_scaling": false
        },
        .
        .
        .
      ]
    },
    .
    .
    .
  ]
}

📘

  • The scheduled property in the response lists all of the available time slots available for delivery. To place a scheduled order, you must pass the scheduled_id of the desired time slot to the scheduled_id input parameter when creating an order using the Create Order API.
  • The property asap_available in the response signals whether the store is currently open. If asap_available is false, then the store is currently isn't accepting ASAP delivery orders, but an order can still be created if there are future time slots available in scheduled. In the example response above, asap_available is true, so the store is open and currently accepting ASAP delivery orders.
  • Note that when the input query parameter pickup is set to false, the delivery_fee and service_fee will, most of the time, be non-zero amounts.

Pickup

Here's an example Get Inventory API request that demonstrates retrieving the pickup inventory and quote for EA Cafe using its store_id: 41c65c6a-71aa-465f-9261-58e900ef11dd.

curl --location 'https://api.mealme.ai/details/inventory?store_id=41c65c6a-71aa-465f-9261-58e900ef11dd&pickup=true&quote_preference=first_available&user_latitude=37.7786357&user_longitude=-122.3918135&user_street_num=188&user_street_name=King%252520Street&user_city=San%252520Francisco&user_state=CA&user_zipcode=94107&user_country=US&include_quote=true' \
--header 'Id-Token: <API KEY' \
--header 'accept: application/json'
{
  "quote": {
    "time_estimate": {
      "minimum": 1159,
      "maximum": 1174,
      "scheduled": [
        {
          "id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-i_kxyHzWWIn31s3myNPc4nBH1xYeVdZ_GDq_8FRJvXJqKNQ3tb6GENkllEQEras8SX0C8QfnNfC-sGFuq_zddC0f7QZQxURoAv8pMyjI3sqYLTMteuIWNoUYK7S0Bl5LQ==",
          "minimum": 1681144200.0,
          "maximum": 1681145100.0,
          "delivery_fee": {
            "delivery_fee_flat": 0,
            "delivery_fee_percent": 0.0,
            "delivery_fee_taxable": false
          }
        },
        {
          "id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-i_kxyHzWWIn31s3myNPc4k6YsEj8D_huQPbuNBcevX3zjRW4faN3awT_cKItW22ywjFyrZ6iwSNg90M2Hey3Ua4WBUymBtWSbYyrZK0_uXpAdoJRN-BSO9ITwGZckVSug==",
          "minimum": 1681145100.0,
          "maximum": 1681146000.0,
          "delivery_fee": {
            "delivery_fee_flat": 0,
            "delivery_fee_percent": 0.0,
            "delivery_fee_taxable": false
          }
        },
        .
        .
        .
      ]
    },
    "sales_tax_percent": 8.5,
    "order_minimum": 0,
    "delivery_fee": {
      "delivery_fee_flat": 0,
      "delivery_fee_percent": 0.0,
      "delivery_fee_taxable": false,
      "threshold_fees": []
    },
    "service_fee": {
      "service_fee_flat": 0,
      "service_fee_percent": 0.0,
      "service_fee_min": 0,
      "service_fee_taxable": false
    },
    "small_order_fee": {
      "minimum_order_value": 0,
      "small_order_fee_flat": 0,
      "small_order_fee_percent": 0.0
    },
    "asap_available": false,
    "first_party_quote": false,
    "third_party_quote": true,
    "courier_quote": false
  },
  "menu_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-rf_tZMnSYQ08zcTPU8LGSz7GauJ48t1jCA0if5ReaV-qVd7_WbSvsnUYoJYkgx48giCkmHs07o6c_nSYcR_BuuqcXD9QSiH6b8euFfodKeX48rbk0IEuIzObbd3J5IxoOjgOtG8oWqibrQjO6yKm9gbE4Qm_YlTu9sqHZ6QtyYTcutj2qc1TuNKB2erd2usHtp990trPmLq_EEmAbZZX2ekTIap2I-t77s96kQo1YJkXB1N7z5yD3-htq7NIbNiPzJP8n9rJIET3zeDbeOip6lE6By7WHgGsyp02A8hqI48ozXzhrGYPwdbxGyc0pPZQVcFQhEeKM1lQG8f_sZbyII=",
  "categories": [
    {
      "name": "Appetizers",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-iSPl94znEL1rJeHQ1JvH4_ezPGCfHH7wjasZSWUu6Sczlxp6yM5ng4ZXHvw_AAzIdf4A9YJCIQQCiiIZtn0NIc=",
      "menu_item_list": [
        {
          "name": "Teriyaki Chicken Wings",
          "price": 895,
          "qty_available": null,
          "unit_size": null,
          "unit_of_measurement": "",
          "description": "Cooked wing of a chicken coated in sauce or seasoning.",
          "customizations": [],
          "min_price": 895,
          "original_price": 895,
          "formatted_price": "$8.95",
          "product_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-vcinS-313rSzhZ_nJXtHWc3xRvQMJWaTQhS8qBezNd8dX1PEG9y02xDrx2dVcsEzVN-E8NwGnk-YkZm_QFjj1-LfdwPZgHMq1P4RbLXHsiFIFlp6zkJ1Hu4-t5ZIrw9RVoL_mujAlb2PXOFZLTR6iVauWpQhVaA3vNXrjCghKRRNEDngE8mSSTiqXaX-dqN4HlNkmKwK1HNl7iMzsy3bTpRjle2HNzOAUbmrqZIZonTU8ikwnHmifr8PNyFw7t0p-TRwUdOVHILE4ou6pzFnNXDMA7wzzkgCYMbQn0INgoeng4U_op_bVQvZitb_264ybSRcQiSrViScVfId1LFBI5qh9vnGSe-l-j6YNeJflwin0h_N75ngDb1ZyOW8d1iZPGtaILXnC1XFg3c8HSpNbehjKrKZZvUW2RIHu0vYtrAIYjek2elp1fpnCoV6mPbqCow5Ac25YRV2feinWyj0hqT4XgnRRXhNxf3nIgD2P1CzgNc7dAGcSqkZBz0SXIxsf0fvlHSOSbw-12DiuvAB1X_HPNyvrO9yyhoFkF8Gp1OJQMwnEbGF5XRg-k0fQkQwQonAxalq5LGPV9zHYLkpGFFnjLeGGQsAmb7QCYjqzNw5RChTvvpu1mldQhr_h7O9DS0frpHo7uNKLK1t0dwejn2rNEliwq3k9t9l_XsVT3O",
          "should_fetch_customizations": false,
          "supports_image_scaling": true
        },
        .
        .
        .
      ]
    },
    {
      "name": "Side",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-jI74oYtF2cAuKlQkywQq-yidAxneQrVMCrmUTzg4oGT1Rirrq-u-yQTaJRCzDMKOI2FoCoT5FS4iKztrqx6ZvU=",
      "menu_item_list": [
        {
          "name": "Miso Soup",
          "price": 300,
          "qty_available": null,
          "unit_size": null,
          "unit_of_measurement": "",
          "description": "Soup that is made from miso paste.",
          "image": "https://cdn-img.mealme.ai/8c81b946f07e9ebe45d4df5493d237f3783a5bd9/68747470733a2f2f6d656469612d63646e2e677275626875622e636f6d2f696d6167652f75706c6f61642f7261676a38786239747461666478707478696a6e2e6a7067",
          "customizations": [],
          "min_price": 300,
          "original_price": 300,
          "formatted_price": "$3.00",
          "product_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-mfo1yVp6iRvlMLEEDW7y7LoOYxYx4Gikk8gyqyQLhtGdjzoIrEkAcw2A9YQOUZT93DHGI8viaPmOgb9P0Y6nOiben6ZaplOlPZ81Voy6nCLCEsn4GsSVFriySjjYFm5aXfH7rP4Dlx675_GF4YerXYz5cYd0O3aOHXEIbloG2r_IDJ0WgQyh18l66rUi2naA8vmtZp1Xy589cWjQM9DHPwVVlaH5Pgldr76bWWwz2JRI_Eb4SI-w1m_M0Efmj7n-uqNp_XOg5vQk8OqtucWg9E7NobMzJ3kWfr0l4VqfB9_SAdUw1S2IgVcBr3GhTOWJwYYeGYm2eassR3vvUr_UrGRMACygtdoupxey0O61vRwJID8g1tK7i_VMEzR18ECppUhN040uuTsoD-jb0RRHGqs1NTEMnduNkLbaSS9_i9bQYhc_a5o6IbXVS-w_DOat8-LsAh6rqjKV2dRA4tDQeYDVZ2U3YeZy1bB6l-C6spMrp69x3IOyvt_vw5JMntQdlU4LyuafzJTwbDrJApsIJYK4Wd7MT_ncZJOtNwhgsdJ2qNYCZCycOpErdLZ1Jztv7AaNqMqTk_b1NkljjxVn8f7TUtZuBJIhji6EXBUUAmUeQ0UVGdhEMjGW6WM8tOKvsYiQaTYhLBVTvji6KekCM4=",
          "thumbnail_image": "https://cdn-img.mealme.ai/71de67d41ed72dde1b3b19c18062b0b232da5104/68747470733a2f2f6d656469612d63646e2e677275626875622e636f6d2f696d6167652f75706c6f61642f685f3132352c775f3132352c635f6c696d69742f7261676a38786239747461666478707478696a6e2e6a7067",
          "should_fetch_customizations": false,
          "supports_image_scaling": true
        },
        .
        .
        .
      ]
    },
    .
    .
    .
  ]
}

📘

  • The scheduled property in the response lists all of the available time slots available for pickup.
  • In the example response above, asap_available is false, so the store is currently not accepting ASAP pickup orders, but a scheduled pickup order can be placed since scheduled is non-empty.
  • Note that when the input query parameter pickup is set to true, delivery_fee will always be a zero amount, and service_fee will, in most cases, be a zero amount.

Unavailable Quote

A quote may not always be returned due to reasons such as the delivery distance being out of range, or the store currently being closed.

Here's an example Get Inventory API request that demonstrates retrieving the delivery inventory and quote for EA Cafe using its store_id: 41c65c6a-71aa-465f-9261-58e900ef11dd. Notice that user_latitude and user_longitude are deliberately different in this request for demonstration purposes.

curl --location 'https://api.mealme.ai/details/inventory?store_id=41c65c6a-71aa-465f-9261-58e900ef11dd&pickup=false&quote_preference=first_available&user_latitude=37.814540848761276&user_longitude=-122.28403520620998&user_street_num=188&user_street_name=King%252520Street&user_city=San%252520Francisco&user_state=CA&user_zipcode=94107&user_country=US&include_quote=true' \
--header 'Id-Token: <API KEY>' \
--header 'accept: application/json'
{
  "quote": {
    "error": "This store is out of range for the provided address."
  },
  "menu_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-rf_tZMnSYQ08zcTPU8LGSz7GauJ48t1jCA0if5ReaV-qVd7_WbSvsnUYoJYkgx48giCkmHs07o6c_nSYcR_BuuqcXD9QSiH6b8euFfodKeX48rbk0IEuIzObbd3J5IxoOjgOtG8oWqibrQjO6yKm9gbE4Qm_YlTu9sqHZ6QtyYTcutj2qc1TuNKB2erd2usHtp990trPmLq_EEmAbZZX2ekTIap2I-t77s96kQo1YJkXB1N7z5yD3-htq7NIbNiPzJP8n9rJIET3zeDbeOip6lE6By7WHgGsyp02A8hqI48ozXzhrGYPwdbxGyc0pPZQVcFQhEeKM1lQG8f_sZbyII=",
  "categories": [
    {
      "name": "Appetizers",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-iSPl94znEL1rJeHQ1JvH4_ezPGCfHH7wjasZSWUu6Sczlxp6yM5ng4ZXHvw_AAzIdf4A9YJCIQQCiiIZtn0NIc=",
      "menu_item_list": [
        {
          "name": "Teriyaki Chicken Wings",
          "price": 895,
          "qty_available": null,
          "unit_size": null,
          "unit_of_measurement": "",
          "description": "Cooked wing of a chicken coated in sauce or seasoning.",
          "customizations": [],
          "min_price": 895,
          "original_price": 895,
          "formatted_price": "$8.95",
          "product_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-vcinS-313rSzhZ_nJXtHWc3xRvQMJWaTQhS8qBezNd8dX1PEG9y02xDrx2dVcsEzVN-E8NwGnk-YkZm_QFjj1-LfdwPZgHMq1P4RbLXHsiFIFlp6zkJ1Hu4-t5ZIrw9RVoL_mujAlb2PXOFZLTR6iVauWpQhVaA3vNXrjCghKRRNEDngE8mSSTiqXaX-dqN4HlNkmKwK1HNl7iMzsy3bTpRjle2HNzOAUbmrqZIZonTU8ikwnHmifr8PNyFw7t0p-TRwUdOVHILE4ou6pzFnNXDMA7wzzkgCYMbQn0INgoeng4U_op_bVQvZitb_264ybSRcQiSrViScVfId1LFBI5qh9vnGSe-l-j6YNeJflwin0h_N75ngDb1ZyOW8d1iZPGtaILXnC1XFg3c8HSpNbehjKrKZZvUW2RIHu0vYtrAIYjek2elp1fpnCoV6mPbqCow5Ac25YRV2feinWyj0hqT4XgnRRXhNxf3nIgD2P1CzgNc7dAGcSqkZBz0SXIxsf0fvlHSOSbw-12DiuvAB1X_HPNyvrO9yyhoFkF8Gp1OJQMwnEbGF5XRg-k0fQkQwQonAxalq5LGPV9zHYLkpGFFnjLeGGQsAmb7QCYjqzNw5RChTvvpu1mldQhr_h7O9DS0frpHo7uNKLK1t0dwejn2rNEliwq3k9t9l_XsVT3O",
          "should_fetch_customizations": false,
          "supports_image_scaling": true
        },
        .
        .
        .
      ]
    },
    {
      "name": "Side",
      "subcategory_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-jI74oYtF2cAuKlQkywQq-yidAxneQrVMCrmUTzg4oGT1Rirrq-u-yQTaJRCzDMKOI2FoCoT5FS4iKztrqx6ZvU=",
      "menu_item_list": [
        {
          "name": "Miso Soup",
          "price": 300,
          "qty_available": null,
          "unit_size": null,
          "unit_of_measurement": "",
          "description": "Soup that is made from miso paste.",
          "image": "https://cdn-img.mealme.ai/8c81b946f07e9ebe45d4df5493d237f3783a5bd9/68747470733a2f2f6d656469612d63646e2e677275626875622e636f6d2f696d6167652f75706c6f61642f7261676a38786239747461666478707478696a6e2e6a7067",
          "customizations": [],
          "min_price": 300,
          "original_price": 300,
          "formatted_price": "$3.00",
          "product_id": "gAAAAAAAAAAAvcAsFofXR7XlzNv5B6-g-mfo1yVp6iRvlMLEEDW7y7LoOYxYx4Gikk8gyqyQLhtGdjzoIrEkAcw2A9YQOUZT93DHGI8viaPmOgb9P0Y6nOiben6ZaplOlPZ81Voy6nCLCEsn4GsSVFriySjjYFm5aXfH7rP4Dlx675_GF4YerXYz5cYd0O3aOHXEIbloG2r_IDJ0WgQyh18l66rUi2naA8vmtZp1Xy589cWjQM9DHPwVVlaH5Pgldr76bWWwz2JRI_Eb4SI-w1m_M0Efmj7n-uqNp_XOg5vQk8OqtucWg9E7NobMzJ3kWfr0l4VqfB9_SAdUw1S2IgVcBr3GhTOWJwYYeGYm2eassR3vvUr_UrGRMACygtdoupxey0O61vRwJID8g1tK7i_VMEzR18ECppUhN040uuTsoD-jb0RRHGqs1NTEMnduNkLbaSS9_i9bQYhc_a5o6IbXVS-w_DOat8-LsAh6rqjKV2dRA4tDQeYDVZ2U3YeZy1bB6l-C6spMrp69x3IOyvt_vw5JMntQdlU4LyuafzJTwbDrJApsIJYK4Wd7MT_ncZJOtNwhgsdJ2qNYCZCycOpErdLZ1Jztv7AaNqMqTk_b1NkljjxVn8f7TUtZuBJIhji6EXBUUAmUeQ0UVGdhEMjGW6WM8tOKvsYiQaTYhLBVTvji6KekCM4=",
          "thumbnail_image": "https://cdn-img.mealme.ai/71de67d41ed72dde1b3b19c18062b0b232da5104/68747470733a2f2f6d656469612d63646e2e677275626875622e636f6d2f696d6167652f75706c6f61642f685f3132352c775f3132352c635f6c696d69742f7261676a38786239747461666478707478696a6e2e6a7067",
          "should_fetch_customizations": false,
          "supports_image_scaling": true
        },
        .
        .
        .
      ]
    },
    .
    .
    .
  ]
}

📘

  • As seen in the example response above, when the input query parameters user_latitude and user_longitude are too far from the store, an error is returned instead of a quote.
  • Refer to the table below for a comprehensive list of all quote error types.

Quote Errors

TypeError MessageError Description
DELIVERY_NOT_AVAILABLEDelivery is currently unavailable for this store.The store either doesn't offer delivery at all or just isn't accepting delivery orders at the current time.
PICKUP_NOT_AVAILABLEPickup is currently unavailable for this store.The store either doesn't offer pickup at all or just isn't accepting pickup orders at the current time.
STORE_CLOSEDThis store is closed.The store is currently closed.
OUT_OF_RANGEThis store is out of range for the provided address.The store doesn't support delivering to the provided user's address.
STORE_NOT_AVAILABLEThis store is not available.The store no longer supports accepts online ordering.