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.

OpenAPI document Join the agency programme

Start in three steps

  1. Open Settings → Developers in a store and create a key with the scopes you need. The key is shown once.
  2. Call the store's own address with the key as a Bearer token and the version header.
  3. 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

MethodPathScopeWhat it returns
GET/api/v1/shop—The store the key belongs to: name, currency, host and the key's own scopes.
GET/api/v1/productsproducts:readProducts 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:readOne product by id or handle.
Parameters: id (The product id or its handle.)
GET/api/v1/collectionscollections:readCollections (id and title).
Parameters: limit (Rows per page (1-100, default 50).) offset (Rows to skip.)
GET/api/v1/collections/{id}collections:readOne collection with its products.
Parameters: id (The collection id or its handle.)
GET/api/v1/ordersorders:readOrders, 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:readOne order by id or order number.
Parameters: id (The order id or its number.)
POST/api/v1/ordersorders:writeCreate 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.)
{"lines":[{"sku":"OUD-100","quantity":2}],"email":"buyer@example.com","note":"Wholesale PO 1042"}
GET/api/v1/customerscustomers:readCustomers, 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:readOne 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.

  1. Apply as an agency on the partners page and sign in to the portal by e-mail link.
  2. Once approved, we open your sandbox store (Business plan, every module, test payments).
  3. Issue API keys for it from the portal; they are test-mode keys and work on the sandbox store's own address.

Apply Open the portal

Shopping agents

Every store can also expose its catalogue to AI shopping agents through the agent endpoint, switched on per store.

Developers · Manara · Manara