---
title: "List all prescription history"
method: GET
path: "/ext/v2/prescription-history/"
tags: ["Prescriptions"]
---

# List all prescription history

`GET /ext/v2/prescription-history/`

## Request

- Base URL: `https://connect.vetcove.com`
- URL: `https://connect.vetcove.com/ext/v2/prescription-history/`
- Auth: HTTP bearer

Returns a list of all individual prescriptions across all clinics in the organization. This endpoint includes every prescription issued under each prescription record, providing the complete prescription history. Results are sorted by creation date (descending), with the most recently created prescription history entries appearing first. Prescription history entries are not modified after creation.

## Query parameters

- `ids` integer[], nullable: When provided, filters to objects with these IDs.
- `ending_before` integer, nullable: A cursor used for pagination. Fetches the page of results ending immediately before the object with the given ID. Cannot be used at the same time as `starting_after`.
- `starting_after` integer, nullable: A cursor used for pagination. Fetches the page of results starting immediately after the given ID. Cannot be used at the same time as `ending_before`.
- `limit` integer: The maximum number of items to return per page.
- `is_deleted` 'FALSE' | 'TRUE' | 'ALL': When 'FALSE' (default), filters to non-deleted records only. When 'TRUE', filters to soft-deleted records only. When 'ALL', returns both deleted and non-deleted records.
- `clinic_id` integer, nullable: When provided, filters to prescription history record for the clinic with this ID
- `clinic_client_id` integer, nullable: When provided, filters to prescription history record for the clinic client with this ID
- `clinic_patient_id` integer, nullable: When provided, filters to prescription history record for the clinic patient with this ID
- `prescription_id` integer, nullable: When provided, filters to prescription history record for the prescription record with this ID

## Response `200`

OK

- ConnectPrescriptionHistorySchemaList
  - `data` ConnectPrescriptionHistorySchema[], required: A single page of data contained within this list.
    - `allowed_uses` integer, nullable: The number of fills allowed, each with the specified `quantity`.
    - `client_notes` string, nullable: Additional notes for the client.
    - `clinic_id` integer, required: The ID of the clinic where this prescription was created.
    - `clinic_patient_id` integer, required: The ID of the clinic patient that this prescription is for.
    - `created` string, date-time, required: The datetime this object was created.
    - `days_supply` integer, nullable: How many days one unit of this prescription is intended to last for.
    - `deleted` string, date-time, nullable, required: The datetime this record was soft deleted.
    - `directions` string, nullable: The directions for the prescription.
    - `expiration_date` string, date-time, nullable: When this prescription expires, if applicable.
    - `id` integer, required: The unique identifier for this prescription history record.
    - `is_deleted` boolean, required: Whether this record is soft deleted or not.
    - `is_prn` boolean, required: Whether the prescription is PRN (as needed).
    - `item` ConnectPrescriptionFillItemSchema, required
      - `id` integer, required: The ID of the catalog item prescribed.
      - `name` string, required: The name of the catalog item prescribed.
    - `modified` string, date-time, required: The datetime this object was last modified; changes to related entities will not update this field.
    - `prescribed_at` string, date-time, required: The date and time when the prescription was written.
    - `prescribed_by` string, nullable: The name of the doctor who prescribed the prescription.
    - `prescribed_by_doctor_id` integer, nullable: The ID of the doctor who prescribed the prescription. Use with the Doctors endpoint to look up full doctor details.
    - `prescription_id` integer, required: The ID of the prescription record that this prescription history entry belongs to.
    - `quantity` integer, required: How many of the items should be provided for each fill.
    - `rx_notification_sent_at` string, date-time, nullable: The timestamp of when the prescription created notification was sent. Null if no notification has been sent.
    - `scheduled_rx_notification_sent_at` string, date-time, nullable: The timestamp of when the scheduled prescription created notification was sent. Null if no scheduled notification has been sent.
    - `status` 'ACTIVE' | 'DRAFT' | 'DECLINED' | 'IMPORTED', required
    - `total_allowed_uses` integer, nullable: The total quantity for which the prescription can be used for the item. None if the prescription is PRN.
  - `has_more` boolean: Whether there are more pages or data in this list.
  - `next_page` string, required: A URL linking to the next page of this list.
  - `type` string: Type of this object. Always `list`.

---

[API](https://skmtc.dev/vetcove/apis/ninjaapi.md) - [All operations](https://skmtc.dev/vetcove/apis/ninjaapi/llms.txt) - [OpenAPI document](https://skmtc.dev/vetcove/apis/ninjaapi/revisions/4ceaed956e15?raw)