Get Category Products

Retrieves a paginated list of products of a specific category.

Endpoint

POST https://partners.waffarx.com/api/{partner}/GetPartnerProductsByCategory

Request Headers

Header	Description
wxc-id	Your WaffarX Client Id
wxc-auth	Signature auth header for the request
wxc-date	UTC timestamp of the request, e.g. 2024-04-24T12:34:56Z
Accept-Language	Response language preference (e.g. en | ar)
Content-Type	Must be application/json

Note

wxc-id: The WaffarX client ID specified in your integration data.

Path Parameters

Name	Type	Required	Description
partner	string		The partner name

Request Parameters

Name	Type	Required	Description
PageNumber	integer		Page number to retrieve (1-based index, must be ≥ 1)
PageSize	integer		Number of items per page (1–50)
CategoryId	string		Id of the category to retrieve products for

Request Body

Example Request Body

{
  "PageNumber": 1,
  "PageSize": 20,
  "CategoryId": "69714272eb6ea0df3a122c02"
}

cURL Example

curl -X POST "https://partners.waffarx.com/api/{partner}/getpartnerproductsbycategory" \
  -H "Content-Type: application/json" \
  -H "Accept-Language: en" \
  -H "wxc-id: {YOUR_CLIENT_ID}" \
  -H "wxc-date: 2025-05-04T22:34:33Z" \
  -H "wxc-auth: 9e177beaee0d90ddb6b26e9b2886bc9de16f5363bad6db8286848cbc90" \
  -d '{
    "PageNumber": 1,
    "PageSize": 1,
    "CategoryId": "69714272eb6ea0df3a122c02"
  }'

Responses

Success (HTTP 200)

Success Response Example

 {
   "code": null,
   "status": "Success",
   "data": {
       "categoryName": "test",
       "products": [
           {
               "id": "6900087bca845254d6edd3d0",
               "name": "ايفون 16 برو ماكس مع فيس تايم - 1 تيرا بايت، 8 جيجا رام",
               "merchantName": "",
               "price": 106000,
               "priceText": "106000.0 EGP",
               "oldPrice": 125500,
               "oldPriceText": "125500.0 EGP",
               "discounted": true,
               "discountedText": "15.54%",
               "category": "إلكترونيات",
               "brand": "ابل",
               "currency": "EGP",
               "primaryImg": "https://www.dubaiphone.net/wp-content/uploads/2025/10/Apple-IPhone-16-Pro-Max-With-FaceTime-1TB-8GB-RAM_Apple_23565_1.jpeg",
               "errorImg": "https://waffarxcdn-akcrhqbhbah9gpcc.z01.azurefd.net/waffarx-cdn/img/productsearcherror.png",
               "shoppingUrl": "https://partners-test.waffarx.com/api/valu/shoppingtrip/productsearch//6900087bca845254d6edd3d0",
               "shoppingUrlBase": "/api/valu/shoppingtrip/productsearch//6900087bca845254d6edd3d0",
               "variantsImgs": [],
               "store": {
                   "shoppingUrl": null,
                   "shoppingUrlBase": null,
                   "logo": null,
                   "logoPng": null,
                   "backgroundColor": null,
                   "id": "00000000-0000-0000-0000-000000000000",
                   "name": null
               },
               "offers": [],
               "rateCard": null,
               "isDeleted": false,
               "quantity": 6,
               "isPartnerProduct": true,
               "heroProduct": false,
               "partnerDiscounted": false,
               "partnerBrand": {
                   "brandId": null,
                   "brandName": null,
                   "brandImage": null
               }
           },
           {
               "id": "690f76652c10cd73d5846971",
               "name": "ايفون 16 برو مع فيس تايم - 512 جيجا، 8 جيجا رام",
               "merchantName": "",
               "price": 89000,
               "priceText": "89000.0 EGP",
               "oldPrice": 105500,
               "oldPriceText": "105500.0 EGP",
               "discounted": true,
               "discountedText": "15.64%",
               "category": "إلكترونيات",
               "brand": "ابل",
               "currency": "EGP",
               "primaryImg": "https://www.dubaiphone.net/wp-content/uploads/2025/10/Apple-IPhone-16-Pro-With-FaceTime-512GB-8GB-RAM_Apple_23562_1.jpeg",
               "errorImg": "https://waffarxcdn-akcrhqbhbah9gpcc.z01.azurefd.net/waffarx-cdn/img/productsearcherror.png",
               "shoppingUrl": "https://partners-test.waffarx.com/api/valu/shoppingtrip/productsearch//690f76652c10cd73d5846971",
               "shoppingUrlBase": "/api/valu/shoppingtrip/productsearch//690f76652c10cd73d5846971",
               "variantsImgs": [],
               "store": {
                   "shoppingUrl": null,
                   "shoppingUrlBase": null,
                   "logo": null,
                   "logoPng": null,
                   "backgroundColor": null,
                   "id": "00000000-0000-0000-0000-000000000000",
                   "name": null
               },
               "offers": [],
               "rateCard": null,
               "isDeleted": false,
               "quantity": 11,
               "isPartnerProduct": true,
               "heroProduct": false,
               "partnerDiscounted": false,
               "partnerBrand": {
                   "brandId": null,
                   "brandName": null,
                   "brandImage": null
               }
           }
       ],
       "filters": {
           "minPrice": 0,
           "maxPrice": 500000,
           "brands": [],
           "stores": [],
           "offers": []
       },
       "totalRecords": 2
   },
   "message": null,
   "errors": null
 }

Error (HTTP 4XX/5XX)

Error Response Example

{
  "status": "Error",
  "data": null,
  "message": "",
  "errors": ["Invalid PageNumber: must be ≥ 1"]
}