Get product

curl --request GET \
  --url https://store.salesive.com/api/v1/products/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'x-shop-id: <api-key>'

{
  "id": "<string>",
  "name": "<string>",
  "price": 123,
  "description": "<string>",
  "currency": "<string>",
  "category": "<string>",
  "status": "<string>",
  "images": [
    "<string>"
  ],
  "addons": [
    {
      "name": "<string>",
      "price": 123,
      "maxQuantity": 2,
      "available": true,
      "_id": "<string>",
      "description": "<string>",
      "image": "<string>"
    }
  ],
  "variants": [
    {
      "sku": "<string>",
      "options": {},
      "stock": 1
    }
  ]
}

GET

products

{id}

Get product

curl --request GET \
  --url https://store.salesive.com/api/v1/products/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'x-shop-id: <api-key>'

{
  "id": "<string>",
  "name": "<string>",
  "price": 123,
  "description": "<string>",
  "currency": "<string>",
  "category": "<string>",
  "status": "<string>",
  "images": [
    "<string>"
  ],
  "addons": [
    {
      "name": "<string>",
      "price": 123,
      "maxQuantity": 2,
      "available": true,
      "_id": "<string>",
      "description": "<string>",
      "image": "<string>"
    }
  ],
  "variants": [
    {
      "sku": "<string>",
      "options": {},
      "stock": 1
    }
  ]
}

Request

GET /products/69fb494e51280f9f65d059ae
x-shop-id: {{shopId}}

Standard product catalogs accept either the MongoDB product ID or the generated slug in the id path segment. Food and service catalogs currently resolve by MongoDB item ID.

Headers

Header	Type	Description
`x-shop-id`	string	Identify the shop context.

Path parameters

Parameter	Type	Description
`id`	string	Product ID or slug.

Restaurant storefronts return catalogType: "food" / itemType: "food", and business storefronts return catalogType: "service" / itemType: "service" on the item payload. Service items include addons and video.

Successful response

{
    "status": 200,
    "success": true,
    "message": "Food found",
    "data": {
        "_id": "68e5bb463a1fc56a8ac150c0",
        "shop": {
            "_id": "68b8f52575da81b332af29f1",
            "name": "Sample Kitchen",
            "currency": {
                "_id": "68c54dd440e9beff3260c2b2",
                "name": "Nigerian Naira",
                "symbol": "₦",
                "code": "NGN",
                "id": "68c54dd440e9beff3260c2b2"
            },
            "logo": "https://cdn.salesive.com/logos/shop.webp",
            "id": "68b8f52575da81b332af29f1"
        },
        "category": {
            "_id": "69fb494ddf63302ed89ba11d",
            "name": "Pizza",
            "id": "69fb494ddf63302ed89ba11d"
        },
        "createdAt": "2026-05-06T13:59:42.799Z",
        "description": "<p>Stone-baked pizza with basil and tomato sauce</p>",
        "featured": false,
        "images": [
            "https://cdn.salesive.com/foods/margherita.webp"
        ],
        "name": "Margherita Pizza",
        "price": 8500,
        "promoPrice": 7500,
        "updatedAt": "2026-05-06T14:44:04.903Z",
        "video": null,
        "available": true,
        "addons": [
            {
                "_id": "68e5bb463a1fc56a8ac150d1",
                "name": "Extra Cheese",
                "description": "A richer mozzarella finish baked on top.",
                "price": 1500,
                "maxQuantity": 3,
                "image": null,
                "available": true
            }
        ],
        "id": "68e5bb463a1fc56a8ac150c0",
        "inWishlist": false,
        "itemType": "food",
        "catalogType": "food"
    }
}

Error response

{
    "status": 404,
    "success": false,
    "message": "Food not found",
    "data": {}
}

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

string

required

Product's MongoDB identifier or slug.

Response

Product detail response.

string

required

Unique product identifier.

name

string

required

Display name of the product.

price

number<float>

required

Unit price for the product.

itemType

enum<string>

Catalog item type.

Available options:

product,

food,

service

catalogType

enum<string>

Catalog response type for the current storefront.

Available options:

product,

food,

service

description

string

Rich description of the product.

currency

string

ISO currency code for the product price.

​Request

​Headers

​Path parameters

​Successful response

​Error response

Authorizations

Headers

Path Parameters

Response

Request

Headers

Path parameters

Successful response

Error response