---
title: "List Notes"
method: GET
path: "/team-messaging/v1/chats/{chatId}/notes"
tags: ["Notes"]
---

# List Notes

`GET /team-messaging/v1/chats/{chatId}/notes`

Returns the list of chat notes.

## Path parameters

- `chatId` string, required

## Query parameters

- `creationTimeTo` string
- `creationTimeFrom` string
- `creatorId` string
- `status` 'Active' | 'Draft'
- `pageToken` string
- `recordCount` integer

## Response `200`

OK

- TMNoteList
  - `records` TMNoteInfo[]
    - `id` string — Internal identifier of a note
    - `title` string — Title of a note
    - `chatIds` string[] — Internal identifiers of the chat(s) where the note is posted or shared.
    - `preview` string — Preview of a note (first 150 characters of a body)
    - `creator` TMCreatorInfo — Note creator information
      - `id` string — Internal identifier of a user who created a note/task
    - `lastModifiedBy` LastModifiedByInfo — Note last modification information
      - `id` string — Internal identifier of the user who last updated the note
    - `lockedBy` LockedByInfo — Returned for the note being edited (locked) at the current moment. Information on the user editing the note
      - `id` string — Internal identifier of the user editing the note
    - `status` 'Active' | 'Draft' — Note publishing status. Any note is created in 'Draft' status. After it is posted it becomes 'Active'
    - `creationTime` string, date-time — Creation time
    - `lastModifiedTime` string, date-time — Datetime of the note last update
    - `type` 'Note'
  - `navigation` TMNavigationInfo
    - `prevPageToken` string — Previous page token. To get previous page, user should pass one of returned token in next request and, in turn, required page will be returned with new tokens
    - `nextPageToken` string — Next page token. To get next page, user should pass one of returned token in next request and, in turn, required page will be returned with new tokens

## Other responses

- `400` — Some of the parameters are missing or have invalid format
- `403` — You do not have permissions to get such kind of information.
- `404` — Group Not Found.

---

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