---
title: "Get Private Notes in a Chat"
method: GET
path: "/chats/{chat_id}/notes"
tags: ["chats"]
---

# Get Private Notes in a Chat

`GET /chats/{chat_id}/notes`

This endpoint retrieves a paginated list of all private notes from a specific chat (in descending order of timestamp). 

#### Response

The response is an array of JSON note objects. Refer to [the note object here](/api-reference/objects/the-note-object)

## Path parameters

- `chat_id` string, required — - The unique id of a chat - For groups, enter the chat_id of the group. This will be a string that ends with @g.us - For 1-1 chats, enter the country_code + number of the recipient e.g. [919537851844@c.us](https://mailto:919537851844@c.us) (The @c.us is optional)

## Query parameters

- `offset` number — - The offset value for paginating the results - Default `0`
- `limit` number — - The maximum number of notes to retrieve - Default `500`
- `start_time` string — - Filter for all notes from the start_time timestamp onwards
- `end_time` string — - Filter for all notes up to the end_time timestamp

## Headers

- `x-phone` string

## Response `200`

Note

- object
  - `from` number — The starting index of the notes returned
  - `to` number — The ending index of the notes returned
  - `start_time` string — The start_time of the notes returned. The format should be YYYY-MM-DDTHH:MM:SSZ
  - `end_time` string — The end_time of the notes returned. The format should be YYYY-MM-DDTHH:MM:SSZ
  - `count` number — The total number of notes returned
  - `notes` unknown[] — An array of note objects. Refer to [the note object here](/api-reference/objects/the-note-object)
    - unknown

---

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