> ## Documentation Index
> Fetch the complete documentation index at: https://developer.worldly.io/llms.txt
> Use this file to discover all available pages before exploring further.

# PM Categories

## Introduction

The Categories endpoint allows you to retrieve the full list of supported product categories and their nested sub-categories. These categories are required when creating or updating products in the Worldly Product Module (PM).

## Category types

The categories are grouped by major product types. Each entry in the response array corresponds to one of these types:

* `Apparel`
* `Footwear`
* `HomeTextiles`
* `Other`

## Response structure

The response returns an array of objects. Each object contains a `type` and a `categories` object containing the hierarchical category data.

* `type`: The top-level product classification (e.g., "Apparel").
* `categories`: A nested object containing the specific sub-categories and options available for that product type.

Check the [Product Module Data Dictionary](/data-dictionary/pm) for more details on category values.


## OpenAPI

````yaml api-reference/openapi/product-module-api.json GET /category
openapi: 3.0.0
info:
  title: product-module-api
  version: 1.0.0
servers:
  - url: https://api-v2.production.higg.org/pm-api/v1/product
    description: Production
  - url: https://api-v2.demo.higg.org/pm-api/v1/product
    description: Demo
security:
  - sec0: []
    sec1: []
paths:
  /category:
    get:
      operationId: GetCategory
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/ProductCategoryType'
                type: array
components:
  schemas:
    ProductCategoryType:
      properties:
        type:
          $ref: '#/components/schemas/MsiProductType'
        categories:
          type: object
      required:
        - categories
        - type
      type: object
      additionalProperties: false
    MsiProductType:
      enum:
        - Apparel
        - Footwear
        - HomeTextiles
        - Other
      type: string
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: x-api-key
    sec1:
      type: apiKey
      in: header
      name: x-developer-request-token

````