---
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`

## Request

- Base URL: `https://companySubDomain.bamboohr.com`
- URL: `https://companySubDomain.bamboohr.com/api/v1/performance/employees/{employeeId}/goals/{goalId}/comments`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Authorization code: `/authorize.php`
    - Token URL: `/token.php` scopes: `goal`
- TypeScript: <https://skmtc.dev/bamboohr/apis/bamboohr-api/docs/api/v1/performance/employees/:employeeId/goals/:goalId/comments/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/bamboohr/apis/bamboohr-api.md) - [All operations](https://skmtc.dev/bamboohr/apis/bamboohr-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bamboohr/apis/bamboohr-api/revisions/922fc15f43a7?raw)