# List categories

Endpoint: GET /categories
Version: 2.0.0
Security: oauth2ClientCredentials

## 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)
    Category documents

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

  - `docs.groupid` (string)
    Group ID

  - `docs.name` (string)
    Category name

  - `docs.description` (string)
    Category description

  - `docs.subcategories` (array)
    Subcategories array

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

  - `docs.subcategories.group_id` (string)
    Group ID

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

  - `docs.subcategories.code` (string)
    Subcategory code

  - `docs.subcategories.name` (string)
    Subcategory name

  - `docs.subcategories.description` (string)
    Subcategory description

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

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

  - `docs.subcategories.createdAt` (string)
    Created timestamp

  - `docs.subcategories.updatedAt` (string)
    Updated timestamp

  - `docs.subcategories.mapping_id` (string)
    Mapping ID

  - `docs.subcategories.icon` (string)
    Icon

  - `docs.subcategories.__v` (number)
    Version key

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

  - `docs.createdAt` (string)
    Created timestamp

  - `docs.updatedAt` (string)
    Updated timestamp

  - `docs.__v` (number)
    Version key

  - `total` (number)
    Total count

  - `limit` (object)
    Limit per page

  - `page` (object)
    Current page

  - `pages` (number)
    Total pages