Suppliers API: Manage Suppliers for Your Shop

Supplier records let you link products to their source and keep contact details in one place. All supplier endpoints are scoped to a shop.

List suppliers

GET /api/v1/shops/{shop_id}/suppliers

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

Returns an array of SupplierOut objects.

Create a supplier

POST /api/v1/shops/{shop_id}/suppliers

string

required

Supplier’s business or trading name.

string

Name of the primary contact person at the supplier.

string

Supplier contact phone number.

string

Supplier contact email address.

string

Physical or mailing address for the supplier.

string

Free-text notes about this supplier (e.g. payment terms, delivery schedule).

curl -X POST https://api.mutasib.com/api/v1/shops/42/suppliers \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Al-Fajr Distributors",
    "contact_name": "Khaled Mansour",
    "phone": "+213551234567",
    "email": "[email protected]",
    "address": "Zone Industrielle, Blida",
    "notes": "Delivers every Monday. Net-30 payment terms."
  }'

Get a supplier

GET /api/v1/shops/{shop_id}/suppliers/{supplier_id}

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

Update a supplier

PATCH /api/v1/shops/{shop_id}/suppliers/{supplier_id} Send only the fields you want to change. Accepts the same fields as SupplierIn.

curl -X PATCH https://api.mutasib.com/api/v1/shops/42/suppliers/9 \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "phone": "+213559876543" }'

Delete a supplier

DELETE /api/v1/shops/{shop_id}/suppliers/{supplier_id}

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

Returns 204 No Content on success.

`SupplierOut` fields

integer

Unique supplier ID.

string

Supplier business name.

string

Primary contact person, if set.

string

Contact phone number, if set.

string

Contact email address, if set.

string

Supplier address, if set.

string

Free-text notes about the supplier.

string

ISO 8601 timestamp of when the supplier was added.

Shops

Products

Sales & Inventory

Public & Misc

Suppliers API: Manage Suppliers for Your Shop

List suppliers

Create a supplier

Get a supplier

Update a supplier

Delete a supplier

`SupplierOut` fields

​List suppliers

​Create a supplier

​Get a supplier

​Update a supplier

​Delete a supplier

​SupplierOut fields

List suppliers

Create a supplier

Get a supplier

Update a supplier

Delete a supplier

`SupplierOut` fields