# List patient category transitions

Retrieve the category transition history for the patient. Shows when and why the patient's category changed over time.

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

## Query parameters:

  - `fromCategoryId` (integer)
    Filter by from category ID

  - `toCategoryId` (integer)
    Filter by to category ID

  - `startDate` (string)
    Start of date range (ISO 8601)

  - `endDate` (string)
    End of date range (ISO 8601)

  - `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):

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

  - `transitions` (array)
    List of category transitions

  - `transitions.changedBy` (string)
    Staff member who made the change (if manual)
    Example: "Jane Smith"

  - `transitions.fromCategoryId` (integer)
    Previous category ID (null if first assignment)
    Example: 111

  - `transitions.fromCategoryName` (string)
    Previous category name
    Example: "New Patient"

  - `transitions.id` (integer)
    Unique transition identifier
    Example: 12345

  - `transitions.patientId` (integer)
    Patient ID
    Example: 67890

  - `transitions.reason` (string)
    Reason for the transition
    Example: "Patient completed onboarding"

  - `transitions.toCategoryId` (integer)
    New category ID
    Example: 222

  - `transitions.toCategoryName` (string)
    New category name
    Example: "Active Patient"

  - `transitions.transitionedAt` (string)
    When the transition occurred
    Example: "2025-01-15T14:30:00Z"

  - `transitions.trigger` (string)
    How the transition was triggered
    Enum: "MANUAL", "AUTOMATED", "SYSTEM", "API"


## Response 401 fields

## Response 403 fields

## Response 404 fields