Developers
Build on Manara
A store API with scoped keys, signed webhooks and a sandbox store for every agency. Products, collections, orders and customers; one key per store and per person.
Start in three steps
- Open Settings → Developers in a store and create a key with the scopes you need. The key is shown once.
- Call the store's own address with the key as a Bearer token and the version header.
- Listen to webhooks: every body is signed with your endpoint's secret; verify before you trust it.
curl https://your-store.example/api/v1/orders?limit=10&status=paid \
-H "Authorization: Bearer mk_…" \
-H "X-Manara-Api-Version: 2026-10"Endpoints
| Method | Path | Scope | What it returns |
|---|---|---|---|
GET | /api/v1/shop | — | The store the key belongs to: name, currency, host and the key's own scopes. |
GET | /api/v1/products | products:read | Products with their variants, prices and stock. Parameters: limit (Rows per page (1-100, default 50).) offset (Rows to skip.) status (active, draft or archived.) since (Only rows updated at or after this time (ISO 8601).) |
GET | /api/v1/products/{id} | products:read | One product by id or handle. Parameters: id (The product id or its handle.) |
GET | /api/v1/collections | collections:read | Collections (id and title). Parameters: limit (Rows per page (1-100, default 50).) offset (Rows to skip.) |
GET | /api/v1/collections/{id} | collections:read | One collection with its products. Parameters: id (The collection id or its handle.) |
GET | /api/v1/orders | orders:read | Orders, newest first. Contact details appear only when the key may read customers. Parameters: limit (Rows per page (1-100, default 50).) offset (Rows to skip.) status (paid, pending, fulfilled, cancelled …) since (Only rows updated at or after this time (ISO 8601).) |
GET | /api/v1/orders/{id} | orders:read | One order by id or order number. Parameters: id (The order id or its number.) |
POST | /api/v1/orders | orders:write | Create an order from SKUs (a wholesale purchase order, a marketplace sale). Idempotent on the Idempotency-Key header. Parameters: Idempotency-Key (Your own reference; the same key returns the same order.) |
GET | /api/v1/customers | customers:read | Customers, newest first. Parameters: limit (Rows per page (1-100, default 50).) offset (Rows to skip.) since (Only rows updated at or after this time (ISO 8601).) |
GET | /api/v1/customers/{id} | customers:read | One customer. Parameters: id (The customer id.) |
120 requests a minute per key by default (the store can change it). 401 when the key is missing or revoked, 403 when it lacks the scope, 429 when the limit is hit.
Webhook events
order.created— An order was placed.order.paid— An order was paid.order.cancelled— An order was cancelled.fulfillment.created— A shipment or pickup was created.refund.created— A refund was recorded.product.created— A product was added.product.updated— A product changed.
OpenAPI document
Generated from the same list as this page; import it into Postman, Insomnia or your code generator.
Sandbox stores
Agencies on the partner programme get a sandbox store on the Business plan with every module on: real screens, test payments, no customers.
- Apply as an agency on the partners page and sign in to the portal by e-mail link.
- Once approved, we open your sandbox store (Business plan, every module, test payments).
- Issue API keys for it from the portal; they are test-mode keys and work on the sandbox store's own address.
Shopping agents
Every store can also expose its catalogue to AI shopping agents through the agent endpoint, switched on per store.