> ## Documentation Index > Fetch the complete documentation index at: https://developer.vetcove.com/llms.txt > Use this file to discover all available pages before exploring further. # List all universal prescription history > 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. ## OpenAPI ````yaml get /ext/v2/universal-prescription-history/ openapi: 3.1.0 info: description: '' title: NinjaAPI version: 2.0.0 servers: - url: https://connect.vetcove.com/ security: [] paths: /ext/v2/universal-prescription-history/: get: tags: - Prescriptions summary: List all universal prescription history description: >- 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. operationId: universal_prescription_history_list parameters: - description: When provided, filters to objects with these IDs. in: query name: ids required: false schema: anyOf: - items: type: integer type: array - type: 'null' description: When provided, filters to objects with these IDs. title: Ids - description: >- 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`. in: query name: ending_before required: false schema: anyOf: - type: integer - type: 'null' description: >- 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`. title: Ending Before - description: >- 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`. in: query name: starting_after required: false schema: anyOf: - type: integer - type: 'null' description: >- 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`. title: Starting After - description: The maximum number of items to return per page. in: query name: limit required: false schema: default: 10 description: The maximum number of items to return per page. maximum: 100 minimum: 1 title: Limit type: integer - description: >- 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. in: query name: cursor required: false schema: anyOf: - type: string - type: 'null' description: >- 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. title: Cursor - description: >- 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. in: query name: modified__gte required: false schema: anyOf: - format: date-time type: string - type: 'null' description: >- 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. title: Modified Gte - description: >- 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. in: query name: modified__lte required: false schema: anyOf: - format: date-time type: string - type: 'null' description: >- 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. title: Modified Lte - description: >- 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. in: query name: is_deleted required: false schema: allOf: - enum: - 'FALSE' - 'TRUE' - ALL title: DeletedFilterOption type: string default: 'FALSE' description: >- 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. - description: >- Filter to universal prescription history for the clinic with this ID. in: query name: clinic_id required: false schema: anyOf: - type: integer - type: 'null' description: >- Filter to universal prescription history for the clinic with this ID. title: Clinic Id - description: >- Filter to universal prescription history for the clinic patient with this ID. in: query name: clinic_patient_id required: false schema: anyOf: - type: integer - type: 'null' description: >- Filter to universal prescription history for the clinic patient with this ID. title: Clinic Patient Id - description: >- Filter to universal prescription history for the clinic client with this ID. in: query name: clinic_client_id required: false schema: anyOf: - type: integer - type: 'null' description: >- Filter to universal prescription history for the clinic client with this ID. title: Clinic Client Id - description: Filter to all versions of the prescription with this ID. in: query name: prescription_id required: false schema: anyOf: - type: integer - type: 'null' description: Filter to all versions of the prescription with this ID. title: Prescription Id responses: '200': content: application/json: schema: $ref: '#/components/schemas/Universal_Prescription_HistoryList' description: OK security: - ExternalAPIAuth: [] components: schemas: Universal_Prescription_HistoryList: properties: data: description: A single page of data contained within this list. items: $ref: '#/components/schemas/ConnectUniversalPrescriptionHistorySchema' title: Data type: array has_more: default: false description: Whether there are more pages or data in this list. title: Has More type: boolean next_page: description: A URL linking to the next page of this list. title: Next Page type: string type: default: list description: Type of this object. Always `list`. title: Type type: string required: - data - next_page title: Universal Prescription HistoryList type: object ConnectUniversalPrescriptionHistorySchema: description: >- A version of a universal prescription. Multiple versions may exist for the same logical prescription when it is renewed or edited. properties: allowed_uses: anyOf: - minimum: 0 type: integer - type: 'null' description: The number of fills allowed. None if the prescription is PRN. title: Allowed Uses authorized_by: anyOf: - type: string - type: 'null' description: The name of the clinic user who authorized this prescription. title: Authorized By client_notes: default: '' description: Additional notes for the client. title: Client Notes type: string clinic_id: description: The ID of the clinic where this prescription was created. title: Clinic Id type: integer clinic_patient_id: description: The ID of the clinic patient that this prescription is for. title: Clinic Patient Id type: integer created: description: The datetime this object was created. format: date-time title: Created type: string deleted: anyOf: - format: date-time type: string - type: 'null' description: The datetime this record was soft deleted. title: Deleted directions: default: '' description: The directions for the prescription. title: Directions type: string expiration_date: anyOf: - format: date-time type: string - type: 'null' description: When this prescription expires, if applicable. title: Expiration Date external_prescription: anyOf: - $ref: '#/components/schemas/ConnectExternalPrescriptionSchema' - type: 'null' description: >- External (third-party pharmacy) prescription details. Present when this is an external prescription. fills_remaining: anyOf: - type: integer - type: 'null' description: The number of fills still available. None if PRN. title: Fills Remaining fills_used: description: The number of fills consumed across all fulfillment channels. title: Fills Used type: integer hd_prescription: anyOf: - $ref: '#/components/schemas/ConnectHDPrescriptionSchema' - type: 'null' description: >- Home delivery prescription details. Present when this is a home delivery prescription. id: description: >- The unique identifier for this universal prescription history record. title: Id type: integer internal_prescription: anyOf: - $ref: '#/components/schemas/ConnectInternalPrescriptionSchema' - type: 'null' description: >- Internal (in-clinic) prescription details. Present when this is an internal prescription. is_deleted: description: Whether this record is soft deleted or not. title: Is Deleted type: boolean is_prn: description: Whether the prescription allows unlimited refills (PRN). title: Is Prn type: boolean latest_fill_id: title: Latest Fill Id type: 'null' modified: description: >- The datetime this object was last modified; changes to related entities will not update this field. format: date-time title: Modified type: string original_created: anyOf: - format: date-time type: string - type: 'null' description: >- When the prescription was first created in the system. Null when the source system did not provide an issued date. title: Original Created prescribed_by: anyOf: - type: string - type: 'null' description: The name of the prescribing doctor. title: Prescribed By prescribed_by_doctor_id: anyOf: - type: integer - type: 'null' description: >- The ID of the prescribing doctor. Use with the Doctors endpoint to look up full doctor details. title: Prescribed By Doctor Id prescription_id: description: The ID of the universal prescription this history record belongs to. title: Prescription Id type: integer status: $ref: '#/components/schemas/VisibleUniversalPrescriptionStatus' description: The visible status of the prescription. required: - created - modified - is_deleted - deleted - id - clinic_id - clinic_patient_id - status - is_prn - fills_used - fills_remaining - prescription_id title: Universal Prescription History type: object ConnectExternalPrescriptionSchema: properties: group_service_id: anyOf: - type: integer - type: 'null' description: The ID of the group service, if mapped. title: Group Service Id group_service_name: anyOf: - type: string - type: 'null' description: The name of the group service, if mapped. title: Group Service Name name: anyOf: - type: string - type: 'null' description: The name of the external prescription. title: Name quantity: anyOf: - type: string - type: 'null' description: The prescribed quantity. title: Quantity title: External Prescription type: object ConnectHDPrescriptionSchema: properties: id: description: >- The ID of the HD prescription fill. References the prescription fill history API. title: Id type: integer item_id: description: The ID of the catalog item. title: Item Id type: integer item_name: description: The name of the catalog item. title: Item Name type: string quantity_prescribed: anyOf: - type: string - type: 'null' description: The prescribed quantity, accounting for default units. title: Quantity Prescribed required: - id - item_id - item_name title: Home Delivery Prescription type: object ConnectInternalPrescriptionSchema: properties: group_service_id: description: The ID of the group service. title: Group Service Id type: integer group_service_name: description: The name of the group service. title: Group Service Name type: string quantity: anyOf: - type: string - type: 'null' description: The prescribed quantity. title: Quantity required: - group_service_id - group_service_name title: Internal Prescription type: object VisibleUniversalPrescriptionStatus: enum: - ACTIVE - DISCONTINUED - DEACTIVATED - DECLINED - EXPIRED - DRAFT - IMPORTED - IMPORTED_VOIDED title: VisibleUniversalPrescriptionStatus type: string securitySchemes: ExternalAPIAuth: scheme: bearer type: http ````