Shops: Your Core Business Entity in Mutasib

A shop is the central resource that ties everything together in Mutasib. Every product you list, every sale you record, and every analytics report you generate belongs to a specific shop.

Shops are created and administered from the Mutasib dashboard. The API exposes read and update operations on an existing shop — it does not create, activate, deactivate, or delete shops.

Shop Data Model

The table below describes the key fields returned in a ShopOut response object.

Field	Type	Description
`id`	integer	Unique identifier for the shop
`name`	string	Display name of the shop
`description`	string	Short public description shown in search results
`address`	string	Physical street address
`category`	string	Business category (see Shop Categories)
`phone_number`	string	Contact phone number
`opening_hours`	object	Per-day open/close times (see Opening Hours Format)
`latitude`	float \| null	Optional GPS latitude for geo-search
`longitude`	float \| null	Optional GPS longitude for geo-search
`is_active`	boolean	Whether the shop is currently online
`plan`	string	Active plan on the shop
`plan_features`	object	Feature flags and limits enforced by the current plan

Opening Hours Format

The opening_hours field is a JSON object keyed by lowercase day name. Each day contains an open and close time in 24-hour HH:MM format. Set a day to null to mark it as closed.

{
  "opening_hours": {
    "monday":    { "open": "09:00", "close": "21:00" },
    "tuesday":   { "open": "09:00", "close": "21:00" },
    "wednesday": { "open": "09:00", "close": "21:00" },
    "thursday":  { "open": "09:00", "close": "22:00" },
    "friday":    { "open": "14:00", "close": "23:00" },
    "saturday":  { "open": "10:00", "close": "22:00" },
    "sunday":    null
  }
}

Shop Categories

The category field classifies your business and helps customers find you in filtered searches. Common values include:

Value	Business type
`grocery`	Supermarkets and general grocery stores
`restaurant`	Dine-in and takeaway food service
`pharmacy`	Pharmacies and drug stores
`electronics`	Consumer electronics and accessories
`clothing`	Apparel and fashion retail
`bakery`	Bread, pastries, and baked goods
`butcher`	Meat and poultry shops
`bookstore`	Books, stationery, and educational supplies

API Endpoints

The following endpoints let you read and update a shop. All requests require a valid API token in the Authorization header.

GET /api/v1/shops/{shop_id} — Get shop details

Returns the full ShopOut object for a single shop.

curl https://api.mutasib.com/api/v1/shops/42 \
  -H "Authorization: Bearer YOUR_API_TOKEN"

PATCH /api/v1/shops/{shop_id} — Update a shop

Partially updates shop fields. Only include the fields you want to change.

curl -X PATCH https://api.mutasib.com/api/v1/shops/42 \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "description": "Now open on Sundays!" }'

Get Started

Core Concepts

Guides

Shops: Your Core Business Entity in Mutasib

Shop Data Model

Opening Hours Format

Shop Categories

API Endpoints

​Shop Data Model

​Opening Hours Format

​Shop Categories

​API Endpoints

Shop Data Model

Opening Hours Format

Shop Categories

API Endpoints