# List categories

Retrieve the list of patient categories defined for the account.

Endpoint: GET /partner/v2/account/{accountId}/category
Version: 2.0
Security: PartnerOAuth

## Query parameters:

  - `active` (boolean)
    Filter by active status

  - `cursor` (string)
    Pagination cursor from previous response

  - `limit` (integer)
    Number of results per page (max 100)
    Example: 20

## Path parameters:

  - `accountId` (integer, required)
    Account identifier

## Response 200 fields (application/json):

  - `categories` (array)
    List of categories

  - `categories.active` (boolean)
    Whether this category is active
    Example: true

  - `categories.color` (string)
    Display color (hex code)
    Example: "#4CAF50"

  - `categories.createdAt` (string)
    Creation timestamp
    Example: "2024-01-01T10:00:00Z"

  - `categories.description` (string)
    Category description
    Example: "Patients with appointments in the last 12 months"

  - `categories.id` (integer)
    Unique category identifier
    Example: 12345

  - `categories.isDefault` (boolean)
    Whether this is the default category for new patients
    Example: true

  - `categories.name` (string)
    Category name
    Example: "Active Patient"

  - `categories.patientCount` (integer)
    Number of patients in this category
    Example: 150

  - `categories.sortOrder` (integer)
    Sort order for display
    Example: 1

  - `categories.updatedAt` (string)
    Last update timestamp
    Example: "2025-01-10T14:30:00Z"

  - `nextCursor` (string)
    Opaque cursor for fetching the next page. Null if no more results.


## Response 401 fields

## Response 403 fields