---
title: "List Project Notes Endpoint"
method: GET
path: "/projects/{project_id}/notes"
---

# List Project Notes Endpoint

`GET /projects/{project_id}/notes`

## Request

- Base URL: `https://usemeridian.us` (the document declares no server; this is the origin it was published from)
- URL: `https://usemeridian.us/projects/{project_id}/notes`
- Auth: none declared

Project notes (newest first). ``?tag=X`` filters by tag; ``?query=X`` searches title+body.

5a5bba43 — the dashboard Notes tab renders full note bodies, so this HTTP
endpoint returns the complete rows (``bodies=True``) for backward compat.
The MCP ``get_notes`` tool defaults to the lightweight (no-body) list.

9fa119dd — pass ``?paginate=true`` for the cursor "Load More" envelope
``{notes, has_more, next_cursor}`` (default ``limit=100``, ``cursor`` is the
next offset), mirroring the sprint-items ``?page=`` envelope. Without
``paginate`` the legacy bare-list shape is unchanged.

## Path parameters

- `project_id` string, required

## Query parameters

- `tag` string, nullable
- `query` string, nullable
- `paginate` boolean
- `limit` integer
- `cursor` integer

## Response `200`

Successful Response

- union
  - object[]
  - object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/usemeridian/apis/meridian.md) · [All operations](https://skmtc.dev/usemeridian/apis/meridian/llms.txt) · [OpenAPI document](https://skmtc.dev/usemeridian/apis/meridian/revisions/f37a894bd374?raw)