---
title: "List Goal Comments"
method: GET
path: "/api/v1/performance/employees/{employeeId}/goals/{goalId}/comments"
tags: ["Goals", "Public API"]
---

# List Goal Comments

`GET /api/v1/performance/employees/{employeeId}/goals/{goalId}/comments`

Returns comments for a goal, including each comment's ID, author, text, creation time, and edit/delete permissions. Use this endpoint before updating or deleting a comment when the user identifies a comment by text or says "my comment" rather than providing a comment ID.

OAuth Scopes: goal

## Path parameters

- `employeeId` string, required
- `goalId` string, required

## Response `200`

Returns up to 50 comments for the specified goal, ordered by creation date.

- object
  - `comments` object[] — Array of comment objects for the goal.
    - `id` string — The comment ID.
    - `authorUserId` integer — The user ID of the comment author.
    - `createdAt` string — ISO 8601 UTC timestamp when the comment was created.
    - `text` string — The text content of the comment.
    - `canEdit` boolean — Whether the authenticated caller can edit this comment.
    - `canDelete` boolean — Whether the authenticated caller can delete this comment.

## Other responses

- `403` — The authenticated caller does not have permission to view comments for this goal, or the goal does not belong to this employee.
- `404` — The specified goalId is invalid (non-positive integer).

---

[API](https://skmtc.net/bamboohr/apis/bamboohr-api.md) · [All operations](https://skmtc.net/bamboohr/apis/bamboohr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboohr/bamboohr-api/revisions/19ebf391a399/schema)