API Reference > Sellers API

Sellers API

Last Updated: 2026-04-16

List Sellers

GET/open/v1/sellersScope: seller:read

Returns 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:read

Returns 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.