API Reference > Sellers API
Sellers API
Last Updated: 2026-04-16
List Sellers
GET
/open/v1/sellersScope: seller:readReturns a paginated list of sellers (mall tenants) that your app has been authorized to access. Each seller represents a brand or store operating within a MallPlus-managed mall.
Supports standard pagination and filtering by status (active, inactive) and mall_id.
Example Response
{
"success": true,
"data": {
"items": [
{
"id": "seller_xyz789",
"name": "LeatherCraft Philippines",
"status": "active",
"mall_id": "mall_sm_makati",
"mall_name": "SM Makati",
"contact_email": "ops@leathercraft.ph",
"created_at": "2025-11-01T00:00:00Z"
}
],
"pagination": { "page": 1, "limit": 20, "total": 15, "total_pages": 1 }
}
}Get Seller
GET
/open/v1/sellers/:idScope: seller:readReturns the full profile of a specific seller, including their mall location, operational status, and contact information. Useful for displaying seller details in your integration dashboards or for mapping sellers to your internal systems.
The response also includes the seller's business_type (e.g., retail, F&B, services) and category classification.