Get Stores¶
Retrieves a paginated list of white-labeled stores from the partner dashboard.
Endpoint¶
POST
https://partners.waffarx.com/api/{partner}/GetStores
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. |
Accept-Language |
Response language preference (e.g. |
Content-Type |
Must be |
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) |
Request Body¶
Example Request Body¶
{
"PageNumber": 1,
"PageSize": 20
}
cURL Example¶
curl -X POST "https://partners.waffarx.com/api/{partner}/getstores" \
-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
}'
Responses¶
Success (HTTP 200)¶
Success Response Example¶
{
"totalCount": 4,
"status": "Success",
"data": [
{
"shoppingUrl": "https://partners.waffarx.com/api/valu/shoppingtrip/advertiser/e279d45c-95ac-49c0-b940-c0536455be4a",
"shoppingUrlBase": "/api/valu/shoppingtrip/advertiser/e279d45c-95ac-49c0-b940-c0536455be4a",
"offers": [],
"rateCard": {
"uptoText": "Up to 7%",
"storeValue": 7.00,
"rateCardOptions": [
{
"title": "Apparel",
"rateText": "7 %",
"rateValue": 7.00
},
{
"title": "Bags & Wallets\t",
"rateText": "7 %",
"rateValue": 7.00
},
{
"title": "Eyewear & Optics\t",
"rateText": "7 %",
"rateValue": 7.00
},
{
"title": "Jewelry & Accessories\t",
"rateText": "7 %",
"rateValue": 7.00
},
{
"title": "Footwear",
"rateText": "7 %",
"rateValue": 7.00
},
{
"title": "Classic Watches",
"rateText": "6 %",
"rateValue": 6.00
},
{
"title": "Books",
"rateText": "5 %",
"rateValue": 5.00
},
{
"title": "Sports & Fitness\t",
"rateText": "4 %",
"rateValue": 4.00
},
{
"title": "Beauty\t",
"rateText": "4 %",
"rateValue": 4.00
},
{
"title": "Perfumes\t",
"rateText": "4 %",
"rateValue": 4.00
},
{
"title": "Vehicle Parts Accessories\t",
"rateText": "4 %",
"rateValue": 4.00
},
{
"title": "Musical Instruments",
"rateText": "3.5 %",
"rateValue": 3.50
},
{
"title": "TVs\t",
"rateText": "2.5 %",
"rateValue": 2.50
},
{
"title": "Tools & Home Improvement",
"rateText": "2.5 %",
"rateValue": 2.50
},
{
"title": "Kitchen Appliances\t",
"rateText": "2.5 %",
"rateValue": 2.50
},
{
"title": "Home Decor & Furniture\t",
"rateText": "2.5 %",
"rateValue": 2.50
},
{
"title": "Health & Personal Care\t",
"rateText": "2.5 %",
"rateValue": 2.50
},
{
"title": "Office Products & Supplies\t",
"rateText": "2.5 %",
"rateValue": 2.50
},
{
"title": "Kitchen & Home Supplies\t",
"rateText": "2.5 %",
"rateValue": 2.50
},
{
"title": "Bathing & Body supplies\t",
"rateText": "2.5 %",
"rateValue": 2.50
},
{
"title": "Baby",
"rateText": "2.5 %",
"rateValue": 2.50
},
{
"title": "Toys",
"rateText": "2.5 %",
"rateValue": 2.50
},
{
"title": "Home Appliances\t",
"rateText": "2.5 %",
"rateValue": 2.50
},
{
"title": "Garden & Outdoor\t",
"rateText": "2.5 %",
"rateValue": 2.50
},
{
"title": "Electronics",
"rateText": "2.5 %",
"rateValue": 2.50
},
{
"title": "Laptops & Notebooks\t",
"rateText": "2 %",
"rateValue": 2.00
},
{
"title": "Computers & IT/Networking\t",
"rateText": "2 %",
"rateValue": 2.00
},
{
"title": "Video Games\t",
"rateText": "2 %",
"rateValue": 2.00
},
{
"title": "Supermarket",
"rateText": "2 %",
"rateValue": 2.00
},
{
"title": "Tablets & Accessories\t",
"rateText": "2 %",
"rateValue": 2.00
},
{
"title": "Pet Food & Supplies\t",
"rateText": "2 %",
"rateValue": 2.00
},
{
"title": "USB",
"rateText": "2 %",
"rateValue": 2.00
},
{
"title": "Cameras & Accessories\t",
"rateText": "1 %",
"rateValue": 1.00
},
{
"title": "Mobiles & Accessories\t",
"rateText": "1 %",
"rateValue": 1.00
}
]
},
"id": "e279d45c-95ac-49c0-b940-c0536455be4a",
"name": "Amazon.eg",
"logo": "https://waffarxcdn-akcrhqbhbah9gpcc.z01.azurefd.net/waffarx-cdn/siteimages/stores/advlogo202408150823202320.png",
"logoPng": "https://waffarxcdn-akcrhqbhbah9gpcc.z01.azurefd.net/waffarx-cdn/siteimages/stores/advpnglogo202408150837133713.png",
"backgroundColor": null
},
{
"shoppingUrl": "https://partners.waffarx.com/api/valu/shoppingtrip/advertiser/98b31baf-bcb5-47c9-9bff-c0ac937441de",
"shoppingUrlBase": "/api/valu/shoppingtrip/advertiser/98b31baf-bcb5-47c9-9bff-c0ac937441de",
"offers": [
{
"id": "683da2f25b5e338a323e5fc3",
"name": "Exclusive at",
"description": "25% CashBack",
"isRewardOffer": true,
"typeName": "Rewards",
"isStoreLevel": true,
"isProductLevel": false
},
{
"id": "683da3dce75bd53c5006dd8d",
"name": "Exclusive at",
"description": "25% CashBack",
"isRewardOffer": true,
"typeName": "Rewards",
"isStoreLevel": true,
"isProductLevel": false
}
],
"rateCard": null,
"id": "98b31baf-bcb5-47c9-9bff-c0ac937441de",
"name": "B.TECH",
"logo": "https://waffarxcdn-akcrhqbhbah9gpcc.z01.azurefd.net/waffarx-cdn/siteimages/stores/advlogo202208150652345234.png",
"logoPng": "https://waffarxcdn-akcrhqbhbah9gpcc.z01.azurefd.net/waffarx-cdn/siteimages/stores/advpnglogo20220815070937937.png",
"backgroundColor": "#120202"
}
],
"message": null,
"errors": null
}
Error (HTTP 4XX/5XX)¶
Error Response Example¶
{
"status": "Error",
"data": null,
"message": "",
"errors": ["Invalid PageNumber: must be ≥ 1"]
}