Expose product type taxonomy

get

https://api-gateway.walmart.com/v3/items/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).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

version

string

enum

required

Specifies the taxonomy version that has to be provided based on which hierarchy data is retrieved.

This is an enumerated value. The current supported versions are listed below.

Valid values are:

Value	Meaning
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.
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.
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.
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
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.
5.0.20250121-19_24_23	Version 5.0.20250121-19_24_23 contains the Product Type Taxonomy updated for the April 2025 Item setup and Maintenance API Release.
5.0.20241118-04_39_24	Version 5.0.20241118-04_39_24 contains the Product Type Taxonomy updated for the February 2025 Item setup and Maintenance API Release.

Market availability: Global

Allowed:

Headers

WM_CONSUMER.CHANNEL.TYPE

string

Identifier that tracks the consumer request by channel.

Use the consumer channel type received during your onboarding.

Contact your system administrator or developer management for the correct WM_CONSUMER.CHANNEL.TYPE value.

Market availability: Global

WM_QOS.CORRELATION_ID

string

required

Unique identifier for each API call, used to track and debug issues.

Use a randomly generated GUID for this ID.

Market availability: Global

WM_SEC.ACCESS_TOKEN

string

required

Access token returned by the Create access token request.

This value is required for token-based authentication.

Market availability: Global

Responses

200Successful Operation

401Unauthorized

404Invalid Parameter