Guide
Shops
A shop is the public storefront a seller's products are listed under — separate from the seller profile that represents the business itself. Every endpoint on this page lives under https://api.swiftgoma.com/api/v1/seller.
Public browsing
Anyone can list and view published shops — no authentication required. Only shops with status PUBLISHED appear.
Seller-managed lifecycle
| Status | Meaning |
|---|---|
| DRAFT | Created but not yet published — invisible to buyers. |
| PUBLISHED | Live and visible to buyers. |
| UNPUBLISHED | Taken offline by the seller; can be republished. |
| SUSPENDED | Taken offline by staff. Only staff can reactivate. |
| DELETED | Soft-deleted by the seller. |
A seller creates, updates, publishes, and unpublishes their own shop. Publishing requires the seller profile to already be ACTIVE — a shop can't go live before KYC is approved.
Staff moderation
Suspension cascades
Suspending a shop also blocks new orders and cart activity against every product in it — see Orders. A suspended shop can only be reactivated by staff, never by the seller themselves.
Admins can list all shops platform-wide (with status and search filters), suspend or reactivate one, hard-delete one, or restore a soft-deleted one.
Browse the Shops endpoints in the API Reference