Secure checkout
Thousands of five-star reviews from customers who came back for more. Each product is checked by hand before it goes into the box.
Overview
Start in minutes and get help from a real person whenever you need it. Free shipping on orders over $50 and easy returns within 30 days. Members get early access to new drops and prices only they can see.
Installation
Install the SDK with the package manager your project already uses. It needs Node 18 or newer.
$ npm install @mira-deck/sdk$ yarn add @mira-deck/sdk$ pnpm add @mira-deck/sdkConfiguration
Our packaging is plastic-free and every delivery is carbon-neutral. Thousands of shoppers already trust us, and we work hard to keep it that way. Create a file named mira-deck.config.json in the project root:
{
"project": "mira-deck",
"region": "ap-south",
"categories": ["apparel", "home", "accessories"],
"retries": 3,
"timeoutMs": 8000,
"webhooks": { "enabled": true }
}| Option | Type | Default | Description |
|---|---|---|---|
project | string | - | Your project key from the dashboard. |
region | string | "us-east" | Data centre closest to your shoppers. |
retries | number | 3 | How often a failed call is retried. |
timeoutMs | number | 10000 | Time before a request is cancelled. |
webhooks.enabled | boolean | false | Send events to your endpoint. |
Your first request
We measure success by how many shoppers come back and tell their friends.
- Create an API keyOpen the dashboard, choose Settings › API keys and copy a new secret key.
- Store it safelyKeep the key in an environment variable, never in your source code.
- Make the callRun the snippet below; it prints the first page of results.
import { Client } from "@mira-deck/sdk";
const client = new Client({ apiKey: process.env.API_KEY });
// list the newest products in one category
const page = await client.products.list({ category: "apparel", limit: 20 });
for (const item of page.data) {
console.log(item.name, item.price);
}API reference
Every endpoint returns JSON and uses standard HTTP status codes.
/v1/productsList products with paging and filters./v1/productsCreate a new product./v1/products/{id}Update some fields of a product./v1/products/{id}Archive a product; it can be restored for 30 days.{
"data": [
{ "id": "product_2571", "name": "Linen shirt", "price": 339 }
],
"has_more": true
}Troubleshooting
Next steps
We work directly with makers, so prices stay fair for everyone.