Use this API to retrieve the categories within a specific department. This is typically used after selecting a department from All departments to support category selection, mapping, and internal classification.

Endpoint

GET /v3/utilities/taxonomy/departments/{departmentId}

Request sample

curl -X GET \ "https://marketplace.walmartapis.com/v3/utilities/taxonomy/departments/44003" \ -H "WM_SEC.ACCESS_TOKEN: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM....." \ -H "WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6" \ -H "WM_SVC.NAME: Walmart Service Name"

Modify your code

• Start with the sample cURL and keep the headers unchanged.
• Replace WM_SEC.ACCESS_TOKEN with your current access token.
• Replace WM_QOS.CORRELATION_ID with a new UUID each time you retry.
• Replace the example department ID (44003) in the path with the one you want.
• If you don’t know your department ID, call All departments and copy departmentId from the response.
• Use the returned categoryId values for mapping/classification in your workflow.

Response sample

{ "status": "SUCCESS", "response": { "departmentName": "LAUNDRY AND HOUSEHOLD CHEMICALS", "departmentId": "44003", "category": [ { "categoryName": "CLEANING PRODUCTS", "categoryId": "44106" }, { "categoryName": "LAUNDRY CARE", "categoryId": "44108" }, { "categoryName": "HOUSEHOLD CHEMICALS L3", "categoryId": "1044076" }, { "categoryName": "HOME FRAGRANCE", "categoryId": "44107" }, { "categoryName": "CLEANING TOOLS", "categoryId": "1044080" } ] }
}

Result

You get the set of categories available within a given department, including IDs you can use for mapping and selection.

Next steps

• Use the selected category IDs in your downstream item publishing workflows.
• If your workflow is spec-driven, consider using Taxonomy by spec to ensure your category browsing aligns to the item spec version and feed type you’re using. Refer to the Get item taxonomy by spec API guide for more information.