> ## 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 medical records > Returns a list of all medical records across all clinics in the organization. The medical records are sorted by creation date, with the most recent appearing first. When using modified filters, results are sorted in descending modification date instead. A **medical record** documents a clinic patient visit, including the reason for the visit, clinical notes, and any services performed. Medical records are linked to a clinic patient, a clinic, and optionally to an invoice for billing. ## OpenAPI ````yaml get /ext/v2/medical-records/ openapi: 3.1.0 info: description: '' title: NinjaAPI version: 2.0.0 servers: - url: https://connect.vetcove.com/ security: [] paths: /ext/v2/medical-records/: get: tags: - Medical Records summary: List all medical records description: >- Returns a list of all medical records across all clinics in the organization. The medical records are sorted by creation date, with the most recent appearing first. When using modified filters, results are sorted in descending modification date instead. A **medical record** documents a clinic patient visit, including the reason for the visit, clinical notes, and any services performed. Medical records are linked to a clinic patient, a clinic, and optionally to an invoice for billing. operationId: medical_records_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: >- Filters to medical records associated with the clinic patient with the given ID. in: query name: clinic_patient_id required: false schema: anyOf: - type: integer - type: 'null' description: >- Filters to medical records associated with the clinic patient with the given ID. title: Clinic Patient Id - description: >- Filters to medical records associated with the invoice with the given ID. in: query name: invoice_id required: false schema: anyOf: - type: integer - type: 'null' description: >- Filters to medical records associated with the invoice with the given ID. title: Invoice Id responses: '200': content: application/json: schema: $ref: '#/components/schemas/Medical_RecordList' description: OK security: - ExternalAPIAuth: [] components: schemas: Medical_RecordList: properties: data: description: A single page of data contained within this list. items: $ref: '#/components/schemas/ExternalMedicalRecordSchema' 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: Medical RecordList type: object ExternalMedicalRecordSchema: description: >- A medical record represents a veterinary visit or consultation. It contains SOAP notes (Subjective, Objective, Assessment, Plan) and is associated with assessments, treatments, and other medical data. properties: appointment_id: anyOf: - type: integer - type: 'null' description: >- The ID of the appointment associated with this medical record, if any. title: Appointment Id assessment_ids: default: [] description: List of assessment IDs associated with this medical record. items: type: integer title: Assessment Ids type: array clinic_client_id: description: The ID of the client this medical record belongs to. title: Clinic Client Id type: integer clinic_id: description: The ID of the clinic this medical record belongs to. title: Clinic Id type: integer clinic_patient_id: description: The ID of the patient this medical record belongs to. title: Clinic Patient Id type: integer date_posted: description: The date this medical record was posted. format: date-time title: Date Posted type: string finalized_at: anyOf: - format: date-time type: string - type: 'null' description: When this medical record was finalized, if applicable. title: Finalized At followup_appointment_ids: default: [] description: >- List of followup appointment IDs associated with this medical record. items: type: integer title: Followup Appointment Ids type: array id: description: The unique identifier for the medical record. title: Id type: integer invoice_id: anyOf: - type: integer - type: 'null' description: The ID of the invoice associated with this medical record, if any. title: Invoice Id objective: default: [] description: Objective SOAP notes extracted as a list of strings. items: type: string title: Objective type: array plan: default: [] description: Plan SOAP notes extracted as a list of strings. items: type: string title: Plan type: array subjective: default: [] description: Subjective SOAP notes extracted as a list of strings. items: type: string title: Subjective type: array required: - id - clinic_patient_id - clinic_client_id - clinic_id - appointment_id - invoice_id - date_posted - finalized_at title: Medical Record type: object securitySchemes: ExternalAPIAuth: scheme: bearer type: http ````