--- updatedAt: 2026-06-04T12:53:29.000Z --- # Pro Seller Tier and Rewards Status Call this endpoint to retrieve your Pro Seller tier and rewards status based on your account’s current standing in Walmart’s Pro Seller program. You can retrieve: - Your tier (Rising, Advanced, or Pro Seller) and next eligible tier. - Badge enrollment and award state. - Evaluation window timing, including the next refresh date. - Performance criteria details (targets vs. current values). - Active rewards (for example, fee incentives). Use this endpoint to automate Pro Seller status updates and avoid visiting Seller Center to check your tier and rewards. Refresh cadence: Tier status refreshes twice monthly on the 5th and 20th of each month. Use `nextRefreshDate` to time polling and dashboards. Mexico market note: Only the Pro Seller level is available. `criteriaTier` shows the tier level each metric has met. To earn a tier status by `nextRefreshDate`, all `criteriaTier` values must be equivalent to or higher than the tier you want. For more information and usage examples, refer to the API guide: https://developer.walmart.com/us-marketplace/docs/retrieve-pro-seller-tier-status-and-reward-details # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "Insights Management", "version": "1.0", "description": "The Insights Management API provides sellers with actionable information to optimize their listings:\n* Sellers can locate best-selling items with Trending Items API so they can add those to their catalog of item offerings. \n* Sellers can find out reasons why items go unpublished, fix the issue and republish those items.\n* Sellers can use Listing Quality APIs to gather listing quality metrics about their items and identify any issues that they can fix.\n* Sellers can obtain their overall Listing Quality score, and locate any categories that show items with listing quality issues." }, "x-readme": { "samples-languages": [ "shell" ], "proxy-enabled": false }, "servers": [ { "url": "https://marketplace.walmartapis.com", "description": "Production URL" }, { "url": "https://sandbox.walmartapis.com", "description": "Sandbox URL" } ], "security": [ { "accessToken": [] } ], "paths": { "/v3/insights/sellerIncentives": { "get": { "tags": [ "Insight" ], "summary": "Pro Seller Tier and Rewards Status", "description": "Call this endpoint to retrieve your Pro Seller tier and rewards status based on your account’s current standing in Walmart’s Pro Seller program.\n\nYou can retrieve:\n- Your tier (Rising, Advanced, or Pro Seller) and next eligible tier.\n- Badge enrollment and award state.\n- Evaluation window timing, including the next refresh date.\n- Performance criteria details (targets vs. current values).\n- Active rewards (for example, fee incentives).\n\nUse this endpoint to automate Pro Seller status updates and avoid visiting Seller Center to check your tier and rewards.\n\nRefresh cadence: Tier status refreshes twice monthly on the 5th and 20th of each month. Use `nextRefreshDate` to time polling and dashboards.\n\nMexico market note: Only the Pro Seller level is available.\n\n`criteriaTier` shows the tier level each metric has met. To earn a tier status by `nextRefreshDate`, all `criteriaTier` values must be equivalent to or higher than the tier you want.\n\nFor more information and usage examples, refer to the API guide: https://developer.walmart.com/us-marketplace/docs/retrieve-pro-seller-tier-status-and-reward-details\n\n", "externalDocs": { "description": "View Guide", "url": "/doc/us/mp/us-mp-insights/#19607" }, "operationId": "getSellerIncentivesInfo", "parameters": [ { "in": "header", "name": "Authorization", "description": "Basic authorization header. Base 64 encodes the Client ID and Client Secret retrieved in step two of the integration steps.", "required": true, "schema": { "type": "string" }, "example": "Basic YzcyOTFjNmItNzI5MC00...." }, { "in": "header", "name": "WM_SEC.ACCESS_TOKEN", "description": "Access token obtained from the Token API. This is required for authenticating requests to Walmart Marketplace APIs.", "required": true, "schema": { "type": "string" }, "example": "eyJraWQiOiIxNWNhNGIyYi0yODVjLTQ0ZDUtYmExNC05ZDk1NTlkZmUwNjgiLCJlbmMiOiJBMjU2R0NNIiwiYWxnIjoiZGlyIn0...." }, { "in": "header", "name": "WM_CONSUMER.CHANNEL.TYPE", "description": "A unique ID to identify the consumer request by channel. Use the Consumer Channel Type received during onboarding.", "required": false, "schema": { "type": "string" } }, { "in": "header", "name": "WM_QOS.CORRELATION_ID", "description": "A unique ID that identifies each API call and is used to track and debug issues. Use a randomly generated GUID for this ID.", "required": true, "schema": { "type": "string" }, "example": "b3261d2d-028a-4ef7-8602-633c23200af6" }, { "in": "header", "name": "WM_SVC.NAME", "description": "Specifies the name of the Walmart service being called.", "required": true, "schema": { "type": "string" }, "example": "Walmart Marketplace" } ], "responses": { "200": { "description": "Successful Operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "partnerId": { "type": "string", "description": "Specifies partner id" }, "currentTier": { "type": "string", "description": "Specifies the current tier of the seller" }, "eligibleTier": { "type": "string", "description": "Specifies the next eligible tier for the seller" }, "proSellerBadgeEnrolledDate": { "type": "string", "description": "Specifies when the seller received their badge" }, "criteriaMetadata": { "type": "object", "properties": { "orders": { "type": "number", "description": "Specifies number of orders received in the given timeframe", "format": "double" }, "activeDays": { "type": "number", "description": "Specifies days active on the platform", "format": "double" }, "onTimeDeliveryRate": { "type": "number", "description": "Specifies on time delivery rate in the given timeframe", "format": "double" }, "cancellationRate": { "type": "number", "description": "Specifies cancellation rate in the given timeframe", "format": "double" }, "sellerResponseRate": { "type": "number", "description": "Specifies seller's response rate", "format": "double" }, "shippingScore": { "type": "number", "description": "Specifies seller's shipping score", "format": "double" }, "contentScore": { "type": "number", "description": "Specifies seller's content score", "format": "double" }, "priceMbScore": { "type": "number", "description": "Specifies seller's price meet/beat score", "format": "double" } }, "description": "Specifies the metadata value for each criterion" }, "criteriaTier": { "type": "object", "properties": { "orders": { "type": "string", "description": "Specifies the eligible tier based on number of orders" }, "activeDays": { "type": "string", "description": "Specifies the eligible tier based on active days" }, "onTimeDeliveryRate": { "type": "string", "description": "Specifies the eligible tier based on OTD" }, "cancellationRate": { "type": "string", "description": "Specifies the eligible tier based on cancellation rate" }, "sellerResponseRate": { "type": "string", "description": "Specifies the eligible tier based on seller response rate" }, "shippingScore": { "type": "string", "description": "Specifies the eligible tier based on shipping score" }, "contentScore": { "type": "string", "description": "Specifies the eligible tier based on content score" }, "priceMbScore": { "type": "string", "description": "Specifies the eligible tier based on price meet/beat score" } }, "description": "Specifies the tier for each criterion" }, "isTierOverride": { "type": "boolean", "description": "Indicates if the tier has been overridden" }, "tierOverride": { "type": "string", "description": "Specifies the overridden tier" }, "reasonCodes": { "type": "array", "description": "Specifies the reason codes for tier ineligibility", "items": { "type": "string", "description": "Specifies the reason codes for tier ineligibility" } }, "nextRefreshDate": { "type": "string", "description": "Specifies the date of next tier refresh" }, "rewards": { "type": "array", "description": "Specifies the list of rewards", "items": { "type": "object", "properties": { "reward": { "type": "string", "description": "Specifies name of the eligible reward" }, "isRewardActive": { "type": "boolean", "description": "Indicates reward active status" }, "isRewardOverride": { "type": "boolean", "description": "Indicates if the reward has been overridden" }, "rewardOverrideAction": { "type": "string", "description": "Specifies the reward override action (approve or deny)" } }, "description": "Specifies the list of rewards" } } } }, "example": { "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 } ] } } } } } } } } }, "components": { "securitySchemes": { "accessToken": { "type": "apiKey", "in": "header", "name": "WM_SEC.ACCESS_TOKEN", "description": "Access token required for authenticating API requests.\n\nTo obtain a token, call `POST https://marketplace.walmartapis.com/v3/token` with your client ID and client secret using the client credentials grant type. Refer to the [Token API documentation](https://developer.walmart.com/us-marketplace/docs/get-an-access-token) for details.\n\nPass the resulting token in the `WM_SEC.ACCESS_TOKEN` header with every API request." } } } } ```