This API retrieves a list of departments, which are grouped under super departments. This is typically the first step in a taxonomy browsing flow. Use the returned department IDs as inputs for downstream taxonomy browsing (categories) and for organizing item workflows.

Endpoint

GET /v3/utilities/taxonomy/departments

Request sample

curl -X GET \ "https://marketplace.walmartapis.com/v3/utilities/taxonomy/departments" \ -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

• Use the sample cURL exactly as shown to retrieve the full department list. No query parameters are required for this endpoint.
• Replace WM_SEC.ACCESS_TOKEN with your current access token.
• Replace WM_QOS.CORRELATION_ID with a new UUID each time you retry.
• Use results to drive the next call
  • Copy a departmentId value from the response.
  • Use it as the {departmentId} path value in the All categories endpoint.

Response sample

{ "status": "SUCCESS", "payload": [ { "superDepartment": "13 HOUSEHOLD CHEMICALS", "superDepartmentId": "44000", "departments": [ { "departmentName": "LAUNDRY AND HOUSEHOLD CHEMICALS", "departmentId": "44003" }, { "departmentName": "HOUSEHOLD CHEMICALS MISC L2", "departmentId": "44004" } ] } ]
}

Result

You get a structured list of super departments and their departments, including the departmentId values needed to fetch categories.

Next steps

• Pick a departmentId and call All categories to retrieve the categories under that department.