Retrieve Pro Seller tier status and reward details
Call this endpoint to retrieve the Pro Seller tier and rewards status based on your account’s current standing in Walmart’s Pro Seller program. You can get details including your tier (Rising, Advanced, or Pro Seller), badge eligibility/award state, evaluation window, next refresh date, the underlying performance criteria (targets vs. current values), and any active rewards (such as fee incentives).
Using the Pro Seller tier and rewards API, you can enable automatic updates on the Pro Seller program and eliminate the need to visit Seller Center to view your tier status and available rewards.
Market availability: US | MX I CA
In Mexico market only “Pro-seller” level is available.
The tier status refreshes twice monthly on the 5th and 20th of each month. You can use the nextRefreshDate
to time polling and dashboards.
The criteriaTier
parameter shows the tier the metric status has met. To earn a tier status, all criteriaTier
status must be equivalent or higher to the tier desired by the nextRefreshDate
.
For the detailed criteria and more information about the Pro Seller Program, refer to the following resources:
- US Marketplace - Pro Seller Program and Pro Seller: Overview
- CA Marketplace - Pro Seller: Overview
This page describes an example using only the required parameters and inputs to retrieve Pro Seller tier and reward status. For a full list of customization options and additional capabilities, refer to the Marketplace Insights API Reference.
Endpoint
GET https://marketplace.walmartapis.com/v3/insights/sellerIncentives
Scenarios
This section lists some scenarios when you can use this API.
- Automate rewards tracking - After each refresh on the 5th and 20th of each month, you can call this endpoint to log the changes in tiers, badges, and rewards.
- Strategize to qualify - Use
currentTier
,nextRefreshDate
, and unmet criteria (target vs. current) alongside Item/Order key performance indicators to highlight areas of focus. For each criterion, treat the program thresholds for the relevant tier as your target and your measured value as current; compare the two to identify gaps and strategize accordingly. For instance, you can use the Pro Seller API's response to decide whether you’re maintaining your current tier or aiming to level up before the next refresh. - Review Pro Seller tier status - Upon earning any tier, routinely use this API to review your current tier and current status and strategize on improving your metrics to attain a higher tier. In addition, also monitor your rewards and use your benefits using tools such as Repricer and Review Accelerator to increase your savings.
Sample request
This sample request gets the Pro Seller tier status and reward details for an account.
curl --request GET \ --url https://marketplace.walmartapis.com/v3/insights/sellerIncentives \ --header 'WM_QOS.CORRELATION_ID: <uuid>' \ --header 'WM_SEC.ACCESS_TOKEN: <Access token>' \ --header 'WM_SVC.NAME: Walmart Marketplace' \ --header 'accept: application/json' \
import requests url = "https://marketplace.walmartapis.com/v3/insights/sellerIncentives" headers = { "WM_QOS.CORRELATION_ID": "<uuid>", "WM_SEC.ACCESS_TOKEN": "<Access token>", "WM_SVC.NAME": "Walmart Marketplace", "Accept": "application/json",
} response = requests.get(url, headers=headers)
print(response.status_code)
print(response.text)
Modify your code
- Use a unique
WM_QOS.CORRELATION_ID
for each request. - Replace
WM_SEC.ACCESS_TOKEN
with your valid access token obtained through authentication.
Sample response
This sample response lists the current Pro Seller tier status and reward details for an account.
{ "status": "OK", "payload": { "partnerId": "255045", "currentTier": "Pro Seller", "eligibleTier": "Rising", "proSellerBadgeEnrolledDate": "2025-02-16T00:00:00.000-08:00", "criteriaMetadata": { "orders": 1500, "activeDays": 95, "onTimeDeliveryRate": 93, "cancellationRate": 2.41, "sellerResponseRate": 92, "shippingScore": 67, "contentScore": 66, "priceMbScore": 99.1 }, "criteriaTier": { "orders": "Pro Seller", "activeDays": "Pro Seller", "onTimeDeliveryRate": "Advanced", "cancellationRate": "Rising", "sellerResponseRate": "Rising", "shippingScore": "Pro Seller", "contentScore": "Rising", "priceMbScore": "Pro Seller" }, "isTierOverride": false, "tierOverride": null, "reasonCodes": [], "nextRefreshDate": "2025-02-19T00:00:00.000-08:00", "rewards": [ { "reward": "Pro Seller Badge", "isRewardActive": true, "isRewardOverride": false, "rewardOverrideAction": null }, { "reward": "Search engine marketing", "isRewardActive": true, "isRewardOverride": true, "rewardOverrideAction": "APPROVE" }, { "reward": "Pro Listing Discounts", "isRewardActive": true, "isRewardOverride": false, "rewardOverrideAction": null }, { "reward": "Review accelerator credit", "isRewardActive": true, "isRewardOverride": false, "rewardOverrideAction": null }, { "reward": "Shipping label discount", "isRewardActive": true, "isRewardOverride": true, "rewardOverrideAction": "APPROVE" }, { "reward": "Capital by Walmart", "isRewardActive": true, "isRewardOverride": true, "rewardOverrideAction": "APPROVE" }, { "reward": "Daily Cashflow", "isRewardActive": true, "isRewardOverride": false, "rewardOverrideAction": null } ] }
}
Result
If successful, the API returns an HTTP status 200 OK
with a JSON response. The response includes details of Pro Seller tier status and reward details.
Updated about 21 hours ago