---
updatedAt: 2026-08-10T16:13:40.000Z
---

# Get all departments

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

```bash
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](/us-marketplace/reference/getcategories)** endpoint.

# Response sample

```json
{
  "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](/us-marketplace/docs/get-all-categories)** to retrieve the categories under that department.