---
title: "List all notes"
method: GET
path: "/contacts/{contact_id}/notes"
tags: ["Notes", "Contacts"]
---

# List all notes

`GET /contacts/{contact_id}/notes`

You can fetch a list of notes that are associated to a contact.

## Path parameters

- `contact_id` string, required

## Headers

- `Intercom-Version` '1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14' — Intercom API version.</br>By default, it's equal to the version set in the app package.

## Response `200`

Successful response

- NoteList — A paginated list of notes associated with a contact.
  - `type` string — String representing the object's type. Always has the value `list`.
  - `data` Note[] — An array of notes.
    - `type` string — String representing the object's type. Always has the value `note`.
    - `id` string — The id of the note.
    - `created_at` integer — The time the note was created.
    - `contact` object, nullable — Represents the contact that the note was created about.
      - `type` string — String representing the object's type. Always has the value `contact`.
      - `id` string — The id of the contact.
    - `author` Admin, nullable — Admins are teammate accounts that have access to a workspace.
      - `type` string — String representing the object's type. Always has the value `admin`.
      - `id` string — The id representing the admin.
      - `name` string — The name of the admin.
      - `email` string — The email of the admin.
      - `job_title` string — The job title of the admin.
      - `away_mode_enabled` boolean — Identifies if this admin is currently set in away mode.
      - `away_mode_reassign` boolean — Identifies if this admin is set to automatically reassign new conversations to the apps default inbox.
      - `away_status_reason_id` integer, nullable — The unique identifier of the away status reason
      - `has_inbox_seat` boolean — Identifies if this admin has a paid inbox seat to restrict/allow features that require them.
      - `team_ids` integer[] — This object represents the avatar associated with the admin.
      - `avatar` string, uri, nullable — Image for the associated team or teammate
      - `team_priority_level` TeamPriorityLevel, nullable — Admin priority levels for teams
        - `primary_team_ids` integer[], nullable — The primary team ids for the team
        - `secondary_team_ids` integer[], nullable — The secondary team ids for the team
    - `body` string — The body text of the note.
  - `total_count` integer — A count of the total number of notes.
  - `pages` CursorPages, nullable — Cursor-based pagination is a technique used in the Intercom API to navigate through large amounts of data. A "cursor" or pointer is used to keep track of the current position in the result set, allowing the API to return the data in small chunks or "pages" as needed.
    - `type` 'pages' — the type of object `pages`.
    - `page` integer — The current page
    - `next` StartingAfterPaging, nullable
      - `per_page` integer — The number of results to fetch per page.
      - `starting_after` string, nullable — The cursor to use in the next request to get the next page of results.
    - `per_page` integer — Number of results per page
    - `total_pages` integer — Total number of pages

## Other responses

- `404` — Contact not found

---

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