---
title: "List the note thread of a post in the review portal"
method: GET
path: "/v2/scheduler/review-portals/{publicId}/posts/{postId}/notes"
tags: ["Brand review portal"]
---

# List the note thread of a post in the review portal

`GET /v2/scheduler/review-portals/{publicId}/posts/{postId}/notes`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/scheduler/review-portals/{publicId}/posts/{postId}/notes`
- Auth: none declared

Authenticated. Accepts the brand reviewer session, or a Metricool user allowed to approve posts on the brand (the brand owner, or a collaborator with the approve-posts permission) — the internal preview is read-only (adding notes stays reviewer-only). Returns the full note thread for a post in the portal reviewer's pending set, oldest first, including the agency's notes; the 'mine' flag is computed against the portal reviewer (not the caller), so the preview mirrors the reviewer's view. An unknown {publicId}, a portal of another reviewer, or a post outside the reviewer's pending set returns 404; a Metricool user without permission gets 403.

## Path parameters

- `publicId` string, required
- `postId` integer, required

## Response `200`

OK

- JsonOkListResponseReviewerPostNoteDto
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` ReviewerPostNoteDto[]
    - `id` integer: Note id.
    - `author` string: Author display name (the reviewer's email for reviewer notes).
    - `content` string: Note text exactly as it was stored: markdown, with the mention markers @[userId|name] still in place. The portal renders the markdown and shows each mention with the name written inside its marker — no id ever has to be resolved to display one.
    - `created` DateTimeInfo
      - `dateTime` string, required: Local Date-time represented with a certain timezone
      - `timezone` string: Timezone applied to the datetime
    - `updated` boolean: True when the note has been edited since it was created.
    - `mine` boolean: True when this note was authored by the portal reviewer.

---

[API](https://skmtc.dev/metricool/apis/metricool-api.md) · [All operations](https://skmtc.dev/metricool/apis/metricool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metricool/apis/metricool-api/revisions/aea9d9a8415a?raw)