Skip to main content
Mutasib is an all-in-one shop management platform built for retailers, boutique owners, and their teams. Whether you run a single register or a multi-cashier storefront, Mutasib handles point-of-sale, inventory tracking, and sales analytics under one roof. The Mutasib REST API exposes the core catalog, sales, and inventory operations so you can integrate Mutasib into your own apps, automate workflows, and build custom dashboards on top of your shop data.
The API and your dashboard share the same data. Every action you perform through the API is reflected in your Mutasib dashboard in real time — and vice versa. Record a sale via POST /api/v1/shops/{shop_id}/sales/ and it appears immediately in your sales history, updates your stock levels, and feeds into your analytics and reports. There is no separate “API mode”: the API is a direct interface to the same shop your team uses every day.

​
Key capabilities

Authentication

Authenticate every request with an API token generated from your Mutasib dashboard. Choose a 30-, 60-, or 90-day expiration and revoke anytime.

Shop Details

Read and update your shop — name, address, category, contact info, opening hours, and geolocation.

Products & Catalog

Add, update, and delete products. Manage pricing, categories, images, and barcode lookups across your entire catalog.

Sales & POS

Record sales transactions, fetch daily totals, and generate shareable receipts at the point of sale.

Inventory

Track stock levels in real time, apply manual adjustments, surface low-stock products, and manage suppliers.

Public Marketplace

Let customers discover your shop through public search, nearby-shop lookups, and shareable receipts, no authentication required.

AI Insights

Predict demand and get reorder suggestions with confidence scores and reasoning. Pro plan only.

​
Base URL

All API requests are made over HTTPS. The current version of the API is v1.
Base URL: https://api.mutasib.comPrefix every endpoint with /api/v1/. For example, to get your shop:

​
Authentication

The Mutasib API uses API tokens for authentication. Generate a token from your Mutasib dashboard and include it in the Authorization header on every request:
API tokens expire after 30, 60, or 90 days depending on the expiration you pick when creating them, and you can revoke them anytime from the dashboard. Never include your token as a query parameter, and never commit it to source control, treat it like a password. If a token is compromised, revoke it from the dashboard and generate a new one.
API tokens are not available on a free trial. An active paid plan is required to create and use them.

​
Plans & limits

Your shop’s plan controls which API features are available and at what scale. Plan features are returned on every ShopOut response in the plan_features object, so your integration can branch on capabilities at runtime without hard-coding plan names. Manage your subscription from the Mutasib dashboard.

​
Next steps

Quick Start

Make your first API call in minutes — generate a token, add a product, and record a sale.

Authentication

Learn how API tokens work, which paths are in scope, and how to handle common error codes.