> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mutasib.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mutasib API Documentation

> Mutasib is an all-in-one shop management platform. Use the API to manage products, sales, inventory, suppliers, and the public marketplace.

Mutasib gives shop owners and developers a REST API for building on top of the Mutasib platform — from managing products to processing sales, tracking inventory, and powering the public marketplace.

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Make your first API call in under 5 minutes
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    Generate an API token and authenticate every request
  </Card>

  <Card title="API Reference" icon="code" href="/api/shops/overview">
    Full endpoint reference with request and response examples
  </Card>

  <Card title="Core Concepts" icon="book-open" href="/concepts/shops">
    Understand shops, products, and the data model
  </Card>
</CardGroup>

## What you can build

<CardGroup cols={3}>
  <Card title="Point of Sale" icon="barcode" href="/api/sales/overview">
    Create sales, scan barcodes, and issue digital receipts
  </Card>

  <Card title="Inventory" icon="boxes-stacked" href="/api/inventory/overview">
    Track stock levels, adjust inventory, and catch low-stock alerts
  </Card>

  <Card title="Suppliers" icon="truck" href="/api/analytics/overview">
    Store and manage supplier records scoped to each shop
  </Card>

  <Card title="Public Search" icon="magnifying-glass" href="/api/public/overview">
    Let customers discover your shop and products
  </Card>

  <Card title="Products" icon="tag" href="/api/products/overview">
    Manage your catalog, images, categories, and barcodes
  </Card>

  <Card title="Credit Notes" icon="file-invoice" href="/api/sales/credit-notes">
    Track customer debts, due dates, and settlements
  </Card>
</CardGroup>

## Getting started in 3 steps

<Steps>
  <Step title="Get your API token">
    Sign in to your [Mutasib dashboard](https://mutasib.com/dashboard) and create an API token. Copy it immediately — tokens are shown only once.
  </Step>

  <Step title="Authenticate your requests">
    Pass `Authorization: Bearer YOUR_API_TOKEN` on every request. All API endpoints are prefixed with `https://api.mutasib.com/api/v1/`.
  </Step>

  <Step title="Call the API against your shop">
    Use your shop ID (from the dashboard) to read shop details, manage products, and record sales — for example, `GET /api/v1/shops/{shop_id}`.
  </Step>
</Steps>

<Note>
  API tokens are not available on a free trial. An active paid plan is required to create and use them.
</Note>