Sign in

v1

latestOpenAPI 3.0.02026-07-2483164186.3 KB
Notes

List Notes

List notes for a customer chat or WA Group chat. Use to + from for customer chats, or groupId for WA Group chats. Rate limit: 60 requests per minute per organization.

get/notes

Query parameters

groupIdstring
Example:grp_AbCdEf1234

The groupId of the WA Group. Use this instead of to/from when listing notes for a group chat.

fromstring phone
Example:+919999999999

The WABA phone number with country code. Required when not using groupId.

tostring phone
Example:+919999999999

The customer phone number with country code. Required when not using groupId.

limitnumber
Example:30

Maximum number of notes to return (default 30, max 100)

lastNoteIdstring
Example:uuid-v4

Cursor: ID of the last note from the previous page for pagination

lastNoteDatestring date-time
Example:2026-01-28T10:23:45.123Z

Cursor: timestamp of the last note from the previous page for pagination

Response

List of notes retrieved successfully

hasMoreboolean

Indicates if there are more notes available after this page

lastNoteIdstring nullable

Cursor: ID of the last note in the current page (use with lastNoteDate on the next request)

lastNoteDatestring date-time nullable

Cursor: timestamp of the last note in the current page (use with lastNoteId on the next request)

totalCountnumber

Total number of notes for this chat and customer

Example response

{
  "notes": [
    {
      "id": "uuid-v4",
      "note": "Spoke with customer, follow-up demo scheduled for tomorrow.",
      "createdBy": "Mitul Varshney",
      "updatedBy": "Mitul Varshney",
      "dateCreated": "2026-02-06T11:55:03.170Z",
      "dateUpdated": "2026-02-06T11:55:03.170Z"
    }
  ],
  "hasMore": true,
  "lastNoteId": "uuid-v4",
  "lastNoteDate": "2026-01-28T10:23:45.123Z",
  "totalCount": 42
}