---
title: "List contact notes"
method: GET
path: "/contact/contacts/{id}/notes"
tags: ["Contacts"]
---

# List contact notes

`GET /contact/contacts/{id}/notes`

Returns all notes for a contact, ordered by creation time descending.
The `{id}` path parameter supports a contact ID, a phone number in E.164 format starting with `+`, or a Meta username without the leading `@`. Ambiguous numeric values are resolved as Meta usernames first and fall back to contact IDs only when no matching Meta username exists.
Contact retrieve, list, and search responses do not include notes; use this endpoint to read contact notes.

## Path parameters

- `id` string, required

## Response `200`

Successfully retrieved contact notes.

- ContactNote[]
  - `id` string, required — Unique ID for the contact note.
  - `contactId` string, required — Unique ID of the contact that owns this note.
  - `content` string, required — Note content.
  - `operatorId` string — ID of the actor who created the note.
  - `updateOperatorId` string — ID of the actor who last updated the note.
  - `createTime` string, date-time — The time at which the note was created, formatted in [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339). e.g., `2022-06-01T12:00:00.000Z`.
  - `updateTime` string, date-time — The time at which the note was last updated, formatted in [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339). e.g., `2022-06-01T12:00:00.000Z`.

## Other responses

- `404` — The requested resource does not exist.

---

[API](https://skmtc.dev/ycloud/apis/ycloud-api.md) · [All operations](https://skmtc.dev/ycloud/apis/ycloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ycloud/ycloud-api/revisions/4e13d3ca9df8/schema)