Get All Stores (Site)

Get a paginated list of all active stores with their featured products for public display.

Endpoint

GET /v1/products/all/store/

Authentication

Not required (public endpoint)

Query Parameters

Parameter	Type	Required	Description
page	integer	Yes	Page number (starts at 1)
count	integer	Yes	Items per page (max 100)
search	string	No	Search by store name (case-insensitive)
currency_id	integer	No	Currency ID for price conversion in featured products

Response

Success (200 OK)

{
  "count": 15,
  "data": [
    {
      "id": 1,
      "name": "Tech Store",
      "description": "Best tech products",
      "logo_url": "https://example.com/logo.jpg",
      "email": "store@example.com",
      "contact_phone": "+994501234567",
      "business_address": "123 Main St",
      "preferred_language": "AZERBAIJANI",
      "percent": 10.5,
      "created": "2025-01-15T10:30:00Z",
      "products": [
        {
          "id": 1,
          "product_id": 5,
          "product": {
            "id": 5,
            "store_id": 1,
            "store": {...},
            "category_id": 2,
            "category": {...},
            "brand_id": 1,
            "brand": {...},
            "currency_id": 1,
            "currency": {...},
            "created": "2025-01-15T10:30:00Z"
          },
          "name_az": "Məhsul Adı",
          "name_en": "Product Name",
          "name_es": "Nombre del Producto",
          "name_de": "Produktname",
          "description_az": "Məhsul Təsviri",
          "description_en": "Product Description",
          "sku": "SKU-001",
          "stock_quantity": 100,
          "price": 29.99,
          "discount_percent": 10.0,
          "discount_price": 26.99,
          "currency_name": "AZN",
          "attributes": [
            {
              "id": 1,
              "attribute_id": 1,
              "attribute_name": "Color",
              "attribute_name_az": "Rəng",
              "attribute_name_en": "Color",
              "attribute_name_es": "Color",
              "attribute_name_de": "Farbe",
              "attribute_type": "select",
              "value": "Red",
              "value_az": "Qırmızı",
              "value_en": "Red",
              "value_es": "Rojo",
              "value_de": "Rot",
              "is_filter": true,
              "is_view": true
            }
          ],
          "images": [...],
          "is_wish": false,
          "created": "2025-01-15T10:30:00Z"
        }
      ]
    }
  ]
}

Response Fields

Field	Type	Description
id	integer	Store ID
name	string	Store name
description	string	Store description
logo_url	string	Store logo URL
email	string	Store email
contact_phone	string	Store contact phone
business_address	string	Store business address
preferred_language	string	Store preferred language
percent	float	Store commission percentage
created	string	Store creation timestamp
products	array	Up to 4 most recent product variants from the store

Error Responses

Invalid Pagination (400)

{
  "error": "Invalid pagination parameters"
}

Example Request

curl -X GET "https://api.luxmart.site/v1/products/all/store/?page=1&count=20&search=tech&currency_id=1"

Notes

• Returns only non-deleted stores
• Each store includes up to 4 most recent product variants
• Product prices are converted to the specified currency if currency_id is provided
• discount_percent is the discount percentage (0 if no discount)
• discount_price is the final price after discount (calculated from converted price if currency_id is provided)
• is_wish indicates if the product is in the user's wishlist (requires authentication header)
• Results are ordered by ID descending (newest first)
• Product variants are ordered by ID descending (newest first)