---
updatedAt: 2026-06-29T20:15:51.000Z
---

# Expose product type taxonomy

The GET Taxonomy API call exposes the product type (PT) taxonomy that Walmart uses to classify items. It returns all product types (PTs) in their respective product type groups (PTGs), with product type groups (PTGs) organized into categories.

JSON is the only format supported for the **Expose product type taxonomy** request (GET `/v3/items/taxonomy`).


[block:html]
{
  "html": "<a\n  href=\"https://god.gw.postman.com/run-collection/34477757-6511da9b-7282-4d69-bd30-785314d2e4f4?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D34477757-6511da9b-7282-4d69-bd30-785314d2e4f4%26entityType%3Dcollection%26workspaceId%3D1f673f2c-8ec6-48f9-8459-003eef27c6ab\"\n  target=\"_blank\"\n  style=\"text-decoration: none\"\n>\n  <button>\n    <img\n      src=\"https://run.pstmn.io/button.svg\"\n      alt=\"Run In Postman\"\n      style=\"width: 128px; height: 32px\"\n    />\n  </button>\n</a>"
}
[/block]

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Item Management",
    "description": "Use the Item Management API to set up and manage your items on Walmart.com.",
    "version": "1.0",
    "contact": {
      "name": "contact name"
    }
  },
  "x-readme": {
    "samples-languages": [
      "shell"
    ],
    "proxy-enabled": false
  },
  "servers": [
    {
      "url": "https://api-gateway.walmart.com",
      "description": "Production URL"
    }
  ],
  "tags": [
    {
      "name": "Item Taxonomy",
      "description": "Use the Item Taxonomy endpoint to retrieve the product type taxonomy that Walmart uses to classify items."
    }
  ],
  "paths": {
    "/v3/items/taxonomy": {
      "get": {
        "tags": [
          "Item Taxonomy"
        ],
        "operationId": "getTaxonomyResponse",
        "summary": "Expose product type taxonomy",
        "description": "The GET Taxonomy API call exposes the product type (PT) taxonomy that Walmart uses to classify items. It returns all product types (PTs) in their respective product type groups (PTGs), with product type groups (PTGs) organized into categories.\n\nJSON is the only format supported for the **Expose product type taxonomy** request (GET `/v3/items/taxonomy`).\n",
        "parameters": [
          {
            "name": "version",
            "in": "query",
            "description": "Specifies the taxonomy version that has to be provided based on which hierarchy data is retrieved.\n\nThis is an enumerated value. The current supported versions are listed below.\n\nValid values are:\n\n| Value | Meaning | \n| --- | --- |\n| 5.0.20260803-17_50_56 | Version 5.0.20260803-17_50_56 contains the Product Type Taxonomy updated for the September 2026 Item Setup and Maintenance API Release. |\n| 5.0.20260304-22_45_32 | Version 5.0.20260304-22_45_32 contains the Product Type Taxonomy updated for the April 2026 Item Setup and Maintenance API Release. |\n| 5.0.20260114-19_40_57 | Version 5.0.20260114-19_40_57 contains the Product Type Taxonomy updated for the February 2026 Item Setup and Maintenance API Release. |\n| 5.0.20251118-18_39_44 | Version 5.0.20251118-18_39_44 contains the Product Type Taxonomy updated for the January 2026 Item Setup and Maintenance API Release. |\n| 5.0.20250828-17_32_59 | Version 5.0.20250828-17_32_59 contains the Product Type Taxonomy updated for the October 2025 Item Setup and Maintenance API Release |\n| 5.0.20250612-15_17_48 | Version 5.0.20250612-15_17_48 contains the Product Type Taxonomy updated for the August 2025 Item setup and Maintenance API Release. |\n\n<p style=\"color:green\"><strong>Market availability: Global</strong></p>\n",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "5.0.20260803-17_50_56",
                "5.0.20260304-22_45_32",
                "5.0.20260114-19_40_57",
                "5.0.20251118-18_39_44",
                "5.0.20250828-17_32_59",
                "5.0.20250612-15_17_48"
              ]
            }
          },
          {
            "in": "header",
            "name": "Accept",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Specifies the data type expected in a response sent from the server.\n\nValid values are:\n\n| Value | Meaning |\n| --- | --- |\n| application/json | JSON format for data returned in response. |\n\n<p style=\"color:green\"><strong>Market availability: Global</strong></p>\n",
            "example": "application/json"
          },
          {
            "in": "header",
            "name": "WM_CONSUMER.CHANNEL.TYPE",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Identifier that tracks the consumer request by channel.\n\nUse the consumer channel type received during your onboarding.\n\nContact your system administrator or developer management for the correct `WM_CONSUMER.CHANNEL.TYPE` value.\n\n<p style=\"color:green\"><strong>Market availability: Global</strong></p>\n",
            "example": "0f3e4dd4-0514-4346-b39d-…"
          },
          {
            "in": "header",
            "name": "WM_QOS.CORRELATION_ID",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Unique identifier for each API call, used to track and debug issues.\n\nUse a randomly generated GUID for this ID.\n\n<p style=\"color:green\"><strong>Market availability: Global</strong></p>\n",
            "example": "b3261d2d-028a-4ef7-8602-633c23200af6"
          },
          {
            "in": "header",
            "name": "WM_SEC.ACCESS_TOKEN",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Access token returned by the [Create access token request](https://developer.walmart.com/suppliers/reference/postcreateanaccesstoken).\n\nThis value is required for token-based authentication.\n\n<p style=\"color:green\"><strong>Market availability: Global</strong></p>\n",
            "example": "eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM…"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Operation",
            "content": {
              "application/json": {
                "schema": {
                  "required": [
                    "itemTaxonomy"
                  ],
                  "type": "object",
                  "properties": {
                    "itemTaxonomy": {
                      "type": "object",
                      "description": "Indicates contents for item taxonomy.",
                      "properties": {
                        "category": {
                          "type": "string",
                          "description": "Indicates the name of the product category.",
                          "example": "Beauty"
                        },
                        "description": {
                          "type": "string",
                          "description": "Indicates the description of the category.",
                          "example": "Beauty"
                        },
                        "productTypeGroup": {
                          "type": "array",
                          "description": "Indicates a list of product type groups (PTGs) in a category.",
                          "items": {
                            "type": "object",
                            "properties": {
                              "productTypeGroupName": {
                                "type": "string",
                                "description": "Indicates the name of the specific product type group.",
                                "example": "Fragrances"
                              },
                              "description": {
                                "type": "string",
                                "description": "Indicates the description of the product type group.",
                                "example": "Fragrance"
                              },
                              "productType": {
                                "type": "array",
                                "description": "Indicates a list of product types (PTs) in a product type group.",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "productTypeName": {
                                      "type": "string",
                                      "description": "Indicates the name of the specific product type.",
                                      "example": "Body Sprays"
                                    },
                                    "description": {
                                      "type": "string",
                                      "description": "Indicates the description of the product type.",
                                      "example": "Body spray is a perfume or cologne product, similar to aerosol deodorant, which is intended to be used elsewhere on the body besides the armpits. Body sprays are lighter in strength than cologne, generally less expensive, and double as deodorant a body spray is just a milder form of perfume. Body spray is a mixture of water and alcohol along with various extracts. Body Sprays will also often be called Body Mists or Hair Mists. The Body Sprays product type includes Body Spray bundles, multi sets, and gift sets, as long as they do not contain perfume or cologne.\n"
                                    }
                                  }
                                }
                              },
                              "department": {
                                "type": "array",
                                "description": "Indicates a list of departments in a product type group.",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "departmentName": {
                                      "type": "string",
                                      "description": "Indicates the name of the department.",
                                      "example": "BEAUTY"
                                    },
                                    "departmentNumber": {
                                      "type": "string",
                                      "description": "Indicates the number of the department.",
                                      "example": "46"
                                    }
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    },
                    "status": {
                      "type": "string",
                      "description": "Indicates the status of retrieval of hierarchy data.\n\n`SUCCESS` is returned upon successful retrieval of hierarchy data.\n"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "array",
                      "description": "Array of objects containing error information.",
                      "items": {
                        "type": "object",
                        "properties": {
                          "code": {
                            "type": "string",
                            "description": "Error code of the response.",
                            "example": "UNAUTHORIZED.GMP_GATEWAY_API"
                          },
                          "field": {
                            "type": "string",
                            "description": "Specifies which field contains the error.",
                            "example": "UNAUTHORIZED"
                          },
                          "description": {
                            "type": "string",
                            "description": "Description of the error.",
                            "example": "Unauthorized"
                          },
                          "info": {
                            "type": "string",
                            "description": "Information about the error.",
                            "example": "Unauthorized token or incorrect authorization header.\n\nVerify that you are using the correct format: `Authorization: Basic Base64Encode(clientId:clientSecret)`.\n\nFor more information, refer to https://developer.walmart.com/suppliers/docs/authentication-management.\n"
                          },
                          "severity": {
                            "type": "string",
                            "description": "Severity of the error.",
                            "example": "ERROR"
                          },
                          "category": {
                            "type": "string",
                            "description": "Category of the error.",
                            "example": "DATA"
                          },
                          "causes": {
                            "type": "array",
                            "description": "List of error causes",
                            "items": {
                              "type": "string",
                              "description": "Cause of the error."
                            }
                          },
                          "errorIdentifiers": {
                            "type": "object",
                            "description": "Error identifiers associated with the error."
                          }
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "401 - Unauthorized Error": {
                    "value": {
                      "error": [
                        {
                          "code": "UNAUTHORIZED.GMP_GATEWAY_API",
                          "field": "UNAUTHORIZED",
                          "description": "Unauthorized",
                          "info": "Unauthorized token or incorrect authorization header.\n\nVerify that you are using the correct format: `Authorization: Basic Base64Encode(clientId:clientSecret)`.\n\nFor more information, refer to https://developer.walmart.com/suppliers/docs/authentication-management.\n",
                          "severity": "ERROR",
                          "category": "DATA",
                          "causes": [],
                          "errorIdentifiers": {}
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Invalid Parameter",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "array",
                      "description": "Array of objects containing error information.",
                      "items": {
                        "type": "object",
                        "properties": {
                          "code": {
                            "type": "string",
                            "description": "Error code of the response.",
                            "example": "CONTENT_NOT_FOUND.GMP_ITEM_QUERY_API"
                          },
                          "field": {
                            "type": "string",
                            "description": "Specifies which field contains the error.",
                            "example": "404_NOT_FOUND"
                          },
                          "description": {
                            "type": "string",
                            "description": "Description of the error.",
                            "example": "No items found for the input parameters."
                          },
                          "info": {
                            "type": "string",
                            "description": "Information about the error.",
                            "example": "Requested content could not be found."
                          },
                          "severity": {
                            "type": "string",
                            "description": "Severity of the error.",
                            "example": "INFO"
                          },
                          "category": {
                            "type": "string",
                            "description": "Category of the error.",
                            "example": "APPLICATION"
                          },
                          "causes": {
                            "type": "array",
                            "description": "List of error causes",
                            "items": {
                              "type": "string",
                              "description": "Cause of the error."
                            }
                          },
                          "errorIdentifiers": {
                            "type": "object",
                            "description": "Error identifiers associated with the error."
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-tagGroups": [
    {
      "name": "1P Suppliers Items Reference",
      "tags": [
        "Get Spec",
        "Item Taxonomy",
        "Item Setup",
        "View Items in Catalog",
        "View Item Catalog in Bulk",
        "Maintenance Actions"
      ]
    }
  ]
}
```