Back

    Buyamia Directory API

    v1.0

    List Products

    GET
    /v1/products

    Retrieve a paginated list of products with filters.

    products.read

    Query Parameters

    ParameterTypeDefaultDescription
    limitinteger20Results per page (max 100)
    offsetinteger0Results to skip
    business_iduuidFilter by supplier
    category_iduuidFilter by product category
    searchstringSearch product name/description
    min_pricenumberMinimum price filter
    max_pricenumberMaximum price filter
    statusstringFilter by status (active, draft, archived)

    Example Request

    curl "https://rjpxllsycikfabazvkdh.supabase.co/functions/v1/directory-api/v1/products?business_id=uuid&limit=20" \
      -H "X-API-Key: your-key"

    Response

    {
      "data": [
        {
          "id": "uuid",
          "business_id": "uuid",
          "name": "Executive Standing Desk",
          "slug": "executive-standing-desk",
          "description": "Height-adjustable mahogany desk",
          "price": 5500000,
          "currency": "IDR",
          "unit_of_measure": "piece",
          "min_order_qty": 10,
          "status": "active",
          "category_id": "uuid",
          "images": ["https://..."],
          "specifications": { "material": "Mahogany", "dimensions": "180x80x75cm" },
          "created_at": "2026-01-20T08:00:00Z"
        }
      ],
      "pagination": { "total": 89, "limit": 20, "offset": 0, "has_more": true }
    }
    Last updated on February 23, 2026