Quick Start

Get your first API call working in under 5 minutes.

What you'll learn

How to fetch store details
How to list products with filters
How to view a product's details

Prerequisites

A Store UUID for a Blaze ECOM store
cURL or any HTTP client (Postman, Insomnia, fetch, axios)

Step 1: Get Store Details

The first call any frontend makes is to fetch the store:

cURL

curl -X GET https://ecom-api.staging.blaze.me/api/v1/store \
  -H "Content-Type: application/vnd.api+json" \
  -H "Accept: application/vnd.api+json" \
  -H "X-Store: e87437f2-3e35-4738-af5e-6307e368255c"

JavaScript (fetch)

const STORE_UUID = "e87437f2-3e35-4738-af5e-6307e368255c";
const BASE_URL = "https://ecom-api.staging.blaze.me";

const response = await fetch(`${BASE_URL}/api/v1/store`, {
  headers: {
    "Content-Type": "application/vnd.api+json",
    Accept: "application/vnd.api+json",
    "X-Store": STORE_UUID,
  },
});

const { data } = await response.json();
console.log(data.attributes.name); // "My Cannabis Shop"

Response

{
  "data": {
    "id": "store-uuid",
    "type": "stores",
    "attributes": {
      "name": "My Cannabis Shop",
      "address": "123 Main St",
      "city": "Los Angeles",
      "state": "CA",
      "delivery_enabled": true,
      "pickup_enabled": true,
      "timezone": "America/Los_Angeles"
    }
  }
}

Step 2: List Products

Fetch the first 10 products, no authentication required:

cURL

curl -X GET "https://ecom-api.staging.blaze.me/api/v1/products?limit=10" \
  -H "Content-Type: application/vnd.api+json" \
  -H "Accept: application/vnd.api+json" \
  -H "X-Store: e87437f2-3e35-4738-af5e-6307e368255c"

JavaScript (fetch)

const response = await fetch(`${BASE_URL}/api/v1/products?limit=10`, {
  headers: {
    "Content-Type": "application/vnd.api+json",
    Accept: "application/vnd.api+json",
    "X-Store": STORE_UUID,
  },
});

const { data, meta } = await response.json();
console.log(`${meta.total} products, showing ${data.length}`);
data.forEach((p) =>
  console.log(`${p.attributes.name} - $${p.attributes.price}`),
);

With Filters

# Flower products under $50, sorted by price
curl -X GET "https://ecom-api.staging.blaze.me/api/v1/products?category=flower&max_price=50&order=price_asc&limit=10" \
  -H "Content-Type: application/vnd.api+json" \
  -H "Accept: application/vnd.api+json" \
  -H "X-Store: e87437f2-3e35-4738-af5e-6307e368255c"

Step 3: Get Product Details

Use the product ID or slug from Step 2:

cURL

curl -X GET https://ecom-api.staging.blaze.me/api/v2/products/PRODUCT_ID_OR_SLUG \
  -H "Content-Type: application/vnd.api+json" \
  -H "Accept: application/vnd.api+json" \
  -H "X-Store: e87437f2-3e35-4738-af5e-6307e368255c"

Tip: Use the v2 endpoint for product detail — it returns enriched data with variants and inventory info.

What's Next?

Browse categories: GET /api/v1/products/categories
Get filters: GET /api/v2/products/filters — build dynamic filter UIs
User login: POST /api/v1/auth/login — see the Authentication guide
Create a cart: POST /api/v5/carts — see the Cart & Checkout example

For a full understanding of request/response format, headers, and errors, see the General Concepts guide.

General Concepts