Get categories

You can fetch the categories of the items part of Post-purchase RAP using the Get categories API.

Request to call Get categories API

Example: Request to fetch categories of ELIGIBLE and ENROLLED items in Post-purchase RAP

{ "itemStatus": [ "ENROLLED", "ELIGIBLE" ]
}

Example: Response of fetch categories – SUCCESS scenario

{ "statusCode": 200, "payload": { "itemStatus": ["ENROLLED", "ELIGIBLE"], "categories": ["HARDLINES", "HOME", "APPAREL"] }
}

Example: Response of fetch categories – FAILURE scenario

{ "statusCode": 500, "errors": [ { "code": "500.RR.501", "description": "Internal server error. Please retry after some time", "severity": "ERROR", "category": "Internal server error" } ]
}

Upon success, the API returns the unique set of categories for the items carrying the requested status.

📘

API Throttling: This API endpoint is throttled—if you submit too many feeds too quickly, you might hit Walmart’s rate limits and receive HTTP 429 responses. To learn more about throttling, refer to the Marketplace throttling documentation.