Skip to main content
GET
/
products
/
{id}
/
addons
Get food add-ons
curl --request GET \
  --url https://store.salesive.com/api/v1/products/{id}/addons \
  --header 'Authorization: Bearer <token>' \
  --header 'x-shop-id: <api-key>'
{
  "status": 123,
  "success": true,
  "message": "<string>",
  "data": {
    "itemId": "<string>",
    "name": "<string>",
    "addons": [
      {
        "name": "<string>",
        "price": 123,
        "maxQuantity": 2,
        "available": true,
        "_id": "<string>",
        "description": "<string>",
        "image": "<string>"
      }
    ]
  }
}

​
Request

GET /products/68e5bb463a1fc56a8ac150c0/addons
x-shop-id: {{shopId}}
Use this endpoint for food-enabled storefronts. Standard product catalogs return an empty addons array.

​
Headers

HeaderTypeDescription
x-shop-idstringIdentify the shop context.

​
Path parameters

ParameterTypeDescription
idstringFood item MongoDB ID.

​
Successful response

{
    "status": 200,
    "success": true,
    "message": "Add-ons found",
    "data": {
        "itemId": "68e5bb463a1fc56a8ac150c0",
        "itemType": "food",
        "catalogType": "food",
        "name": "Margherita Pizza",
        "addons": [
            {
                "_id": "68e5bb463a1fc56a8ac150d1",
                "name": "Extra Cheese",
                "description": "A richer mozzarella finish baked on top.",
                "price": 1500,
                "maxQuantity": 3,
                "image": null,
                "available": true
            }
        ]
    }
}

​
Notes

  • Unavailable add-ons are filtered out of this response.
  • Add-on objects include the latest description field from the food catalog.
  • Pair the returned addonId values with POST /cart using selectedAddons.

Authorizations

​
Authorization
string
header
required

JWT issued by the Salesive Store API for authenticated shoppers.

​
x-shop-id
string
header
required

Optional storefront identifier sent as a header to scope responses to a specific shop. Try It requests remember this value once provided.

Headers

​
x-shop-id
string

Optional identifier that scopes responses to a specific storefront when the referer cannot be inferred.

Path Parameters

​
id
string
required

Food item MongoDB identifier.

Response

Add-ons retrieved successfully.

​
status
integer
required
​
success
boolean
required
​
message
string
required
​
data
object
required