Skip to main content
Welcome to the Scale API Reference. This guide will walk you through setting up authentication and making your first API requests to load your shop’s catalog.

​
Prerequisites

Before making requests, make sure you have:
  • A registered store on Scale.
  • Your store’s Shop ID (available in your dashboard settings).
  • A Public / Publishable Key (pk_...) generated from the Developer tab in your dashboard.

​
3-Step Setup

Follow these steps to query products on your custom storefront website or mobile app:
1

Retrieve your API credentials

Log in to your Scale Dashboard, navigate to Settings > Developer, and generate a new Public key. Copy the key (e.g. pk_live_8f3d12...).
2

Add the authentication header

Pass the key in the X-Shop-API-Key header with all your storefront requests:
X-Shop-API-Key: pk_live_YOUR_KEY
3

Query your product catalog

Make a request to fetch all active products for your store:
curl -X GET "https://api.getscale.ng/api/v1/storefront/shop/YOUR_SHOP_ID/products" \
  -H "X-Shop-API-Key: pk_live_YOUR_KEY"

​
Next Steps

API Keys & Auth

Understand the difference between Public and Secret keys

Storefront APIs

Explore catalog, category, and checkout endpoints