---
title: "List notes"
method: GET
path: "/v1/notes"
---

# List notes

`GET /v1/notes`

## Query parameters

- `created_before` union — Return notes created before this date
  - string, date
  - string, date-time
- `created_after` union — Return notes created after this date
  - string, date
  - string, date-time
- `updated_after` union — Return notes updated after this date
  - string, date
  - string, date-time
- `folder_id` string — Return notes in this folder and any of its child folders. Use the list folders endpoint to discover folder IDs.
- `cursor` string — The cursor to continue from
- `page_size` integer — Maximum number of notes to return per page

## Response `200`

List of notes

- ListNotesOutput
  - `notes` NoteSummary[], required
    - `id` string, required — The ID of the note
    - `object` 'note', required — The object type of the note
    - `title` string, nullable, required — The title of the note
    - `owner` User, required
      - `name` string, nullable, required — The name of the user
      - `email` string, email, required — The email of the user
    - `created_at` string, date-time, required — The creation time of the note
    - `updated_at` string, date-time, required — The last update time of the note
  - `hasMore` boolean, required — Whether there are more notes to fetch
  - `cursor` string, nullable, required — The cursor to continue from

## Other responses

- `400` — Bad request
- `401` — Unauthorized - Invalid API key

---

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