---
title: "List all medical records"
method: GET
path: "/ext/v2/medical-records/"
tags: ["Medical Records"]
---

# List all medical records

`GET /ext/v2/medical-records/`

## Request

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

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.

## 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.
- `clinic_patient_id` integer, nullable: Filters to medical records associated with the clinic patient with the given ID.
- `invoice_id` integer, nullable: Filters to medical records associated with the invoice with the given ID.

## Response `200`

OK

- MedicalRecordList
  - `data` ExternalMedicalRecordSchema[], required: A single page of data contained within this list.
    - `appointment_id` integer, nullable, required: The ID of the appointment associated with this medical record, if any.
    - `assessment_ids` integer[]: List of assessment IDs associated with this medical record.
    - `clinic_client_id` integer, required: The ID of the client this medical record belongs to.
    - `clinic_id` integer, required: The ID of the clinic this medical record belongs to.
    - `clinic_patient_id` integer, required: The ID of the patient this medical record belongs to.
    - `date_posted` string, date-time, required: The date this medical record was posted.
    - `finalized_at` string, date-time, nullable, required: When this medical record was finalized, if applicable.
    - `followup_appointment_ids` integer[]: List of followup appointment IDs associated with this medical record.
    - `id` integer, required: The unique identifier for the medical record.
    - `invoice_id` integer, nullable, required: The ID of the invoice associated with this medical record, if any.
    - `objective` string[]: Objective SOAP notes extracted as a list of strings.
    - `plan` string[]: Plan SOAP notes extracted as a list of strings.
    - `subjective` string[]: Subjective SOAP notes extracted as a list of strings.
  - `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)