# List patient medications

Retrieve all medications for a patient including dosage instructions and status.

Endpoint: GET /partner/v2/account/{accountId}/patients/{patientId}/health-profile/medications
Version: 2.0
Security: PartnerOAuth

## Path parameters:

  - `patientId` (integer, required)
    Patient ID
    Example: 67890

  - `accountId` (integer, required)
    Account identifier

## Query parameters:

  - `active` (boolean)
    Filter by active status. If not specified, returns both active and inactive appointment types.
    Enum: true, false

  - `status` (string)
    Filter by status (ACTIVE, ON_HOLD, DISCONTINUED, COMPLETED, UNKNOWN)

## Response 200 fields (application/json):

  - `medications` (array)
    List of medications

  - `medications.active` (boolean)
    Whether this record is active
    Example: true

  - `medications.createdAt` (string)
    Creation timestamp
    Example: "2022-03-01T10:00:00Z"

  - `medications.createdBy` (string)
    Created by (staff name)
    Example: "Dr. Jane Smith"

  - `medications.diagnoses` (array)
    Related diagnoses

  - `medications.diagnoses.diagnosisCode` (string)
    Diagnosis code (ICD-10)
    Example: "I10"

  - `medications.diagnoses.diagnosisText` (string)
    Diagnosis description
    Example: "Essential (primary) hypertension"

  - `medications.diagnoses.id` (integer)
    Unique diagnosis identifier
    Example: 12345

  - `medications.diagnoses.updatedAt` (string)
    Last update timestamp
    Example: "2023-01-10T14:30:00Z"

  - `medications.diagnoses.updatedBy` (string)
    Last updated by (staff name)
    Example: "Dr. Jane Smith"

  - `medications.directions` (string)
    Dosage/usage instructions
    Example: "Take 1 tablet by mouth daily"

  - `medications.endDate` (string)
    End date
    Example: "2023-03-01"

  - `medications.id` (integer)
    Unique medication identifier
    Example: 12345

  - `medications.name` (string)
    Medication name
    Example: "Lisinopril 10mg"

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

  - `medications.referenceId` (string)
    Drug code identifier (NDC, RxNorm)
    Example: "68180-513-01"

  - `medications.startDate` (string)
    Start date
    Example: "2022-03-01"

  - `medications.status` (string)
    Medication status
    Enum: "ACTIVE", "ON_HOLD", "DISCONTINUED", "COMPLETED", "UNKNOWN"


## Response 401 fields

## Response 403 fields

## Response 404 fields