# List subcategories for a category

Endpoint: GET /categories/{categoryId}/subcategories
Version: 2.0.0
Security: oauth2ClientCredentials

## Path parameters:

  - `categoryId` (string, required)

## Query parameters:

  - `page` (number)
    Page number

  - `limit` (number)
    Items per page (max 1000)

## Header parameters:

  - `org_wallet_ref` (string)
    Organization wallet reference, defaults to "1" if not provided

  - `business_id` (string, required)
    Business identifier for the request

## Response 200 fields (application/json):

  - `docs` (array)
    Subcategory documents

  - `docs._id` (string)
    Subcategory MongoDB ID

  - `docs.group_id` (string)
    Group ID

  - `docs.category` (string)
    Parent category ID

  - `docs.code` (string)
    Subcategory code

  - `docs.name` (string)
    Subcategory name

  - `docs.description` (string)
    Subcategory description

  - `docs.status` (string)
    Subcategory status
    Enum: "ACTIVE", "ARCHIVED"

  - `docs.teams` (array)
    Team IDs array

  - `docs.createdAt` (string)
    Created timestamp

  - `docs.updatedAt` (string)
    Updated timestamp

  - `docs.mapping_id` (string)
    Mapping ID

  - `docs.icon` (string)
    Icon

  - `docs.__v` (number)
    Version key

  - `total` (number)
    Total count

  - `limit` (object)
    Limit per page

  - `page` (object)
    Current page

  - `pages` (number)
    Total pages