---
title: "List Notes V2"
method: GET
path: "/v2/notes"
tags: ["Notes v2"]
---

# List Notes V2

`GET /v2/notes`

Returns a paginated list of note metadata.

## Query parameters

- `limit` integer — Limit for pagination
- `offset` integer — Offset for pagination
- `practice_id` integer, nullable — Filter by practice ID
- `is_draft` string, nullable — True to filter to draft notes only. False to include only signed notes. Omit to include both.
- `patient` integer, nullable — Filter by patient ID
- `providers` string, nullable — Comma separated list of provider IDs

## Response `200`

Successful Response

- PaginatedResponseNoteMetadata
  - `count` integer, required
  - `limit` integer, required
  - `next` string, nullable
  - `offset` integer, required
  - `previous` string, nullable
  - `results` NoteMetadata[], required
    - `bill` integer, nullable — ID of the bill associated to the note
    - `category` integer, required — Practice-created identifiers for note category. A category is a Visit Note Type object. See https://docs.elationhealth.com/reference/visit_note_types_list for API to list all available categories.
    - `confidential` boolean — Whether the note is marked as confidential.
    - `doctags` Doctag[]
      - `code` string, nullable
      - `code_type` 'CPT' | 'SNOMED' | 'HL7' | 'ICD9' | 'LOINC' | 'CVX' | 'RXNORM' | 'ICD10' | 'CPTII' | 'HCPCS' | 'EL8'
      - `concept_name` string, nullable
      - `description` string, nullable
      - `id` integer, required
      - `is_cpc_plus` boolean, required
      - `is_mips` boolean, required
      - `practice` integer, nullable
      - `shared` boolean, required
      - `snomed_result_code` string, nullable
      - `value` string, required
    - `id` integer, required
    - `is_draft` boolean, required
    - `metadata` unknown
    - `note_v1_id` integer, nullable
    - `patient` integer, required — The ID of the patient for whom the note was created.
    - `practice` integer, required — Authoring practice ID.
    - `provider` integer, required — The ID of the assigned provider.
    - `serviced_at` string, nullable, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elationhealth/apis/api-authentication.md) · [All operations](https://skmtc.net/elationhealth/apis/api-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elationhealth/api-authentication/versions/c060f89d4de7/schema)