---
title: "GET /api/medications"
method: GET
path: "/api/medications"
tags: ["Clinical"]
---

# GET /api/medications

`GET /api/medications`

## Request

- Base URL: `https://app.drchrono.com`
- URL: `https://app.drchrono.com/api/medications`
- Auth: OAuth 2
  - Authorization code: `https://app.drchrono.com/o/authorize/`
  - Token URL: `https://app.drchrono.com/o/token/` scopes: `clinical:read`, `clinical:write`

Retrieve or search patient medications

## Query parameters

- `cursor` string: The pagination cursor value.
- `page_size` integer: Number of results to return per page.
- `patient` integer
- `doctor` integer

## Response `200`

OK

- object: Paginated Result
  - `previous` string: Previous paginated page
  - `data` PatientDrug[]: result data
    - `dispense_quantity` number
    - `prn` boolean: If `True`, the medication should be taken when necessary
    - `pharmacy_note` string
    - `number_refills` integer
    - `patient` integer, required
    - `id` integer
    - `dosage_quantity` string: Please note, this used to be an decimal field, you can still pass decimal value to it. Or you can pass in some formatted string if needed.
    - `doctor` integer, required: Prescribing doctor ID
    - `date_started_taking` string
    - `dosage_units` string
    - `date_stopped_taking` string
    - `order_status` '' | 'Administered during visit' | 'Discontinued' | 'Electronic eRx Sent' | 'Faxed to Pharmacy' | 'Ordered' | 'Over the Counter' | 'Paper Rx' | 'Phoned into Pharmacy' | 'Prescribed by other Dr' | 'Prescription Printed': One of `""`, `"Ordered"`, `"Administered during visit"`, `"Electronic eRx Sent"`, `"Phoned into Pharmacy"`, `"Faxed to Pharmacy"`, `"Paper Rx"`, `"Prescription Printed"`, `"Discontinued"`, `"Prescribed by other Dr"` or `"Over the Counter"`. If omitted in writing, default to `""`
    - `status` 'active' | 'inactive': If present, one of `"active"` or `"inactive"`. If omitted in writing, default to `"active"`
    - `appointment` integer: Appointment ID corresponding to the initial prescription
    - `daw` boolean: If true, the prescription should be dispensed as written and not substituted
    - `rxnorm` string: RxNorm code for the medication
    - `date_prescribed` string
    - `name` string
    - `ndc` string
    - `notes` string: Any additional notes from the provider
    - `frequency` string: Frequency pf administration
    - `indication` string
    - `signature_note` string
    - `route` string: Route of administration
  - `next` string: Next Paginated page

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Permission Denied
- `404`: Not Found
- `405`: Method Not Allowed
- `500`: Internal Server Error

---

[API](https://skmtc.dev/drchrono/apis/drchrono-api.md) - [All operations](https://skmtc.dev/drchrono/apis/drchrono-api/llms.txt) - [OpenAPI document](https://skmtc.dev/drchrono/apis/drchrono-api/revisions/98cabe79d150?raw)