---
title: "List Notes"
method: GET
path: "/sales/opportunities/{opportunity_id}/notes"
tags: ["Sales::Opportunities::Note"]
---

# List Notes

`GET /sales/opportunities/{opportunity_id}/notes`

## Request

- Base URL: `https://myworkspace.myclickfunnels.com/api/v2`
- URL: `https://myworkspace.myclickfunnels.com/api/v2/sales/opportunities/{opportunity_id}/notes`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://accounts.myclickfunnels.com/oauth/authorize`
    - Token URL: `https://accounts.myclickfunnels.com/oauth/token`
- TypeScript: <https://skmtc.dev/myclickfunnels/apis/clickfunnels-api/docs/sales/opportunities/:opportunity_id/notes/get.ts> (a function with typed inputs; its response is checked against the schema)

List Notes

## Path parameters

- `opportunity_id` string, required

## Query parameters

- `after` string
- `per_page` integer
- `sort_order` 'asc' | 'desc'
- `sort_property` 'id' | 'updated_at'
- `filter` object
  - `id` string: A comma-separated list of note IDs to filter by (within the scope of the opportunity).
  - `created_by_id` string: A comma-separated list of memberships IDs to filter by.

## Response `200`

OK

- SalesOpportunitiesNoteAttributes[]
  - `id` integer: Note ID
  - `public_id` string, nullable: Note public ID
  - `opportunity_id` integer: Opportunity
  - `content` string: Content
  - `created_by_id` integer, nullable: The ID of the Team-`Membership` that created the note. For notes created via the API, this defaults to the ClickFunnels API default User.
  - `created_at` string, date-time, nullable: Note creation date
  - `updated_at` string, date-time, nullable: Note last updated date

## Other responses

- `401`: Unauthorized
- `404`: Not Found
- `422`: Unprocessable Entity - `per_page` must be a positive integer.

## Changes

- **2026-11-03** `511d88b30aea`: 5 info
  - added the new optional `query` request parameter `per_page`
  - for the `path` request parameter `opportunity_id`, the type was generalized from `integer` to `string`
  - added the non-success response with the status `422`
  - added the optional property `hint` to the response with the `401` status
  - …1 more

[Operation history](https://skmtc.dev/myclickfunnels/apis/clickfunnels-api/changes/sales/opportunities/:opportunity_id/notes/get.md)

---

[API](https://skmtc.dev/myclickfunnels/apis/clickfunnels-api.md) - [All operations](https://skmtc.dev/myclickfunnels/apis/clickfunnels-api/llms.txt) - [OpenAPI document](https://skmtc.dev/myclickfunnels/apis/clickfunnels-api/revisions/511d88b30aea?raw)