--- title: "List all universal prescription history" method: GET path: "/ext/v2/universal-prescription-history/" tags: ["Prescriptions"] --- # List all universal prescription history `GET /ext/v2/universal-prescription-history/` ## Request - Base URL: `https://connect.vetcove.com` - URL: `https://connect.vetcove.com/ext/v2/universal-prescription-history/` - Auth: HTTP bearer Returns a list of all universal prescription versions across all clinics in the organization. This includes every version of each prescription, providing the complete history. Results are sorted by creation date (descending). When using modified filters, results are instead sorted by modification date (descending). A **universal prescription** represents a medication or service prescribed to a patient by a veterinarian. Universal prescriptions unify three fulfillment types — home delivery, internal (in-clinic), and external (third-party pharmacy) — into a single record. When a prescription is renewed or edited, a new version is created in the same prescription group, preserving the full history. ## 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. - `cursor` string, nullable: A cursor token used for pagination. This token contains encoded information about the last seen record in order to continue pagination. Cannot be used with `starting_after` or `ending_before` parameters. - `modified__gte` string, date-time, nullable: Filters to objects modified on or after this datetime (ISO8601 UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with `starting_after` or `ending_before` parameters. - `modified__lte` string, date-time, nullable: Filters to objects modified on or before this datetime (ISO8601 UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with `starting_after` or `ending_before` parameters. - `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: Filter to universal prescription history for the clinic with this ID. - `clinic_patient_id` integer, nullable: Filter to universal prescription history for the clinic patient with this ID. - `clinic_client_id` integer, nullable: Filter to universal prescription history for the clinic client with this ID. - `prescription_id` integer, nullable: Filter to all versions of the prescription with this ID. ## Response `200` OK - UniversalPrescriptionHistoryList - `data` ConnectUniversalPrescriptionHistorySchema[], required: A single page of data contained within this list. - `allowed_uses` integer, nullable: The number of fills allowed. None if the prescription is PRN. - `authorized_by` string, nullable: The name of the clinic user who authorized this prescription. - `client_notes` string: 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. - `deleted` string, date-time, nullable, required: The datetime this record was soft deleted. - `directions` string: The directions for the prescription. - `expiration_date` string, date-time, nullable: When this prescription expires, if applicable. - `external_prescription` ConnectExternalPrescriptionSchema - `group_service_id` integer, nullable: The ID of the group service, if mapped. - `group_service_name` string, nullable: The name of the group service, if mapped. - `name` string, nullable: The name of the external prescription. - `quantity` string, nullable: The prescribed quantity. - `fills_remaining` integer, nullable, required: The number of fills still available. None if PRN. - `fills_used` integer, required: The number of fills consumed across all fulfillment channels. - `hd_prescription` ConnectHDPrescriptionSchema - `id` integer, required: The ID of the HD prescription fill. References the prescription fill history API. - `item_id` integer, required: The ID of the catalog item. - `item_name` string, required: The name of the catalog item. - `quantity_prescribed` string, nullable: The prescribed quantity, accounting for default units. - `id` integer, required: The unique identifier for this universal prescription history record. - `internal_prescription` ConnectInternalPrescriptionSchema - `group_service_id` integer, required: The ID of the group service. - `group_service_name` string, required: The name of the group service. - `quantity` string, nullable: The prescribed quantity. - `is_deleted` boolean, required: Whether this record is soft deleted or not. - `is_prn` boolean, required: Whether the prescription allows unlimited refills (PRN). - `latest_fill_id` unknown - `modified` string, date-time, required: The datetime this object was last modified; changes to related entities will not update this field. - `original_created` string, date-time, nullable: When the prescription was first created in the system. Null when the source system did not provide an issued date. - `prescribed_by` string, nullable: The name of the prescribing doctor. - `prescribed_by_doctor_id` integer, nullable: The ID of the prescribing doctor. Use with the Doctors endpoint to look up full doctor details. - `prescription_id` integer, required: The ID of the universal prescription this history record belongs to. - `status` 'ACTIVE' | 'DISCONTINUED' | 'DEACTIVATED' | 'DECLINED' | 'EXPIRED' | 'DRAFT' | 'IMPORTED' | 'IMPORTED_VOIDED', required - `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)