Skip to main content
GET
/
api
/
v1
/
storefront
/
shop
/
{shopId}
/
products
/
{productId}
Get Product Details
curl --request GET \
  --url https://api.getscale.ng/api/v1/storefront/shop/{shopId}/products/{productId} \
  --header 'X-Shop-API-Key: <x-shop-api-key>'
{
  "status": "success",
  "data": {
    "shopProductId": 1,
    "productName": "Air Max Sneaker",
    "productSlug": "air-max-sneaker",
    "productDescription": "Running athletic shoes",
    "productPrice": 12000,
    "currencySymbol": "₦",
    "media": [
      {
        "mediaUrl": "https://cdn.getscale.ng/products/sneaker1.jpg",
        "mediaType": "image",
        "mediaIndex": 0
      }
    ],
    "variants": [
      {
        "variantId": 10,
        "variantPrice": 12500,
        "stockQuantity": 15,
        "options": [
          {
            "optionTypeName": "Color",
            "optionValueName": "Red"
          },
          {
            "optionTypeName": "Size",
            "optionValueName": "42"
          }
        ],
        "variantMedia": []
      }
    ]
  }
}
Fetch complete product profile details for a single item by ID, including variant details, option choices (e.g. Size, Color), variant-specific pricing, image media list, and active inventory stock counts. Use this endpoint to render detail pages, option selectors, image carousel lists, and dynamic stock warning banners when a shopper views a product detail page.

Authorizations

X-Shop-API-Key
string
required
Your Publishable Key (pk_live_... or pk_test_...) generated from the Developer settings in your dashboard.

Path Parameters

shopId
string
required
The unique UUID of the shop.
productId
number
required
The unique ID of the product.
{
  "status": "success",
  "data": {
    "shopProductId": 1,
    "productName": "Air Max Sneaker",
    "productSlug": "air-max-sneaker",
    "productDescription": "Running athletic shoes",
    "productPrice": 12000,
    "currencySymbol": "₦",
    "media": [
      {
        "mediaUrl": "https://cdn.getscale.ng/products/sneaker1.jpg",
        "mediaType": "image",
        "mediaIndex": 0
      }
    ],
    "variants": [
      {
        "variantId": 10,
        "variantPrice": 12500,
        "stockQuantity": 15,
        "options": [
          {
            "optionTypeName": "Color",
            "optionValueName": "Red"
          },
          {
            "optionTypeName": "Size",
            "optionValueName": "42"
          }
        ],
        "variantMedia": []
      }
    ]
  }
}