--- updatedAt: 2026-07-21T16:51:09.000Z --- # Get categories To get the set of categories the RAP post-purchase items belong to. [block:html] { "html": "\n \n" } [/block] # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "Reviews Acceleration", "version": "1.0", "description": "The Reviews Acceleration API lets sellers view and enroll items in the Review Accelerator post-purchase program (RAP). Sellers can: \n\n* View eligible products using the Get RAP post-purchase items API.\n* View currently enrolled products using the same API.\n* Identify products that reached their review target after enrollment.\n* Filter by category and price, sort by item priority, and search by product name or SKU.\n* Enroll or disenroll products in bulk using the bulk update item status API.\n" }, "x-readme": { "samples-languages": [ "shell" ], "proxy-enabled": false }, "servers": [ { "url": "https://marketplace.walmartapis.com", "description": "Refers to the URL used for accessing the production server." }, { "url": "https://sandbox.walmartapis.com", "description": "Refers to the URL used for accessing the sandbox server." } ], "security": [ { "accessToken": [] } ], "paths": { "/v3/growth/reviews-accelerator/categories": { "post": { "tags": [ "Reviews" ], "summary": "Get categories", "description": "To get the set of categories the RAP post-purchase items belong to.", "externalDocs": { "description": "Refer to the guide", "url": "/doc/us/mp/us-mp-reviews/#11539" }, "operationId": "getIrpCategories", "parameters": [ { "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" }, { "in": "header", "name": "Accept", "description": "Only supported Media Type : application/json", "required": true, "schema": { "type": "string" }, "example": "application/json" } ], "requestBody": { "description": "The request payload contains the necessary parameters and criteria required by the API endpoint.", "content": { "application/json": { "schema": { "type": "object", "properties": { "itemStatus": { "type": "array", "description": "An array representing the IRP status values for the items.", "items": { "type": "string", "description": "The IRP status of an individual item.", "enum": [ "ENROLLED", "ELIGIBLE", "COMPLETE" ] }, "enum": [ "ENROLLED", "ELIGIBLE", "COMPLETE" ] } } }, "examples": { "Get categories with status": { "value": { "itemStatus": [ "ENROLLED", "ELIGIBLE", "COMPLETE" ] } } } } }, "required": true }, "responses": { "200": { "description": "Successful Operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "payload": { "type": "object", "properties": { "itemStatus": { "type": "array", "description": "IRP status of the items.", "items": { "type": "string", "description": "IRP status of the items.", "enum": [ "ENROLLED", "ELIGIBLE", "COMPLETE" ] }, "enum": [ "ENROLLED", "ELIGIBLE", "COMPLETE" ] }, "categories": { "type": "array", "description": "Category of the items in requested item status.", "example": "APPAREL", "items": { "type": "string", "description": "Category of the items in requested item status.", "example": "APPAREL" } } }, "description": "Response payload." }, "statusCode": { "type": "integer", "description": "Status code for the request.", "format": "int32", "example": 200 }, "errors": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string", "description": "A unique identifier for the type of error. This helps in quickly recognizing and categorizing the specific issue.", "example": "400.INVALID_REQUEST.003" }, "description": { "type": "string", "description": "A detailed message explaining what caused the error. This provides more context about the issue.", "example": "The request payload is either invalid or is improperly formatted. Check the payload values and try again." }, "category": { "type": "string", "description": "Classifies the error into a specific group or type, which helps in organizing and managing different types of issues.", "example": "DATA" }, "severity": { "type": "string", "description": "Indicates the criticality of the error. Common values include ERROR, WARNING, or INFO.", "example": "ERROR" } } } } } }, "examples": { "Get categories with status": { "value": { "statusCode": 200, "payload": { "itemStatus": [ "ENROLLED", "ELIGIBLE", "COMPLETE" ], "categories": [ "HARDLINES", "HOME", "APPAREL" ] } } } } } } } } } } }, "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 OAuth 2.0 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." } } } } ```