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

# List Goals

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

Returns goals for an employee. Use this endpoint to locate goals by title before updating, commenting on, closing, reopening, or deleting them. Use `filter=status-inProgress` when the user asks for current/active goals, `filter=status-completed` for completed goals, `filter=status-closed` for closed goals, and `filter=status-all` when the user says "all goals", "including closed", or you are resolving a goal by title for a write operation where the status is unknown. If no filter is provided, closed goals are excluded. Results are capped at 50 goals; if a title lookup is ambiguous or absent, do not update or delete a different goal.

OAuth Scopes: goal

## Path parameters

- `employeeId` string, required

## Query parameters

- `filter` 'status-inProgress' | 'status-completed' | 'status-closed' | 'status-all'

## Response `200`

The response content will be a JSON document with the requested information.

- object
  - `goals` TransformedApiGoal[] — All goals of the selected employee
    - `id` string — The id of the goal.
    - `title` string — Title of the goal.
    - `description` string — A description of the goal.
    - `percentComplete` integer — A percentage (0-100) that denotes how complete the goal is.
    - `alignsWithOptionId` string, nullable — The ID of the goal this goal is aligned with. Returns null when not aligned, or an empty string when the goal has no parent set.
    - `sharedWithEmployeeIds` integer[] — Ids of the employees that have access to this goal.
    - `dueDate` string — The due date of the goal.
    - `completionDate` string, nullable — ISO 8601 UTC timestamp of when the goal was completed.
    - `lastChangedDateTime` string, nullable — ISO 8601 UTC timestamp of when the goal was last modified.
    - `status` 'in_progress' | 'completed' | 'closed' — The status of the goal.
    - `milestones` object[], nullable — All milestones for the individual goal. This array will not exist if milestones are not selected for this goal.
      - `id` integer — The id of the milestone.
      - `employeeGoalId` integer — The id of the goal which encompasses this milestone.
      - `title` string — The title of the milestone.
      - `currentValue` number, nullable — The current value for a numeric milestone. This number will be rounded to the nearest hundredth. On the creation of a numeric milestone this value will automatically be set to the start value of the milestone. If the milestone is a simple checkbox milestone, this value will always be null.
      - `startValue` number, nullable — The starting value for a numeric milestone. This number will be rounded to the nearest hundredth. If the milestone is a simple checkbox milestone, this value will always be null.
      - `endValue` number, nullable — The end goal for a numeric milestone. This number will be rounded to the nearest hundredth. If the milestone is a simple checkbox milestone, this value will always be null.
      - `completedDateTime` string — The date and time in which the goal has been completed. If the goal is not completed the value will be null.
      - `lastUpdateDateTime` string — The date and time in which the goal was last updated.
      - `lastUpdateUserId` integer — The ID of the user who last updated this milestone.
    - `actions` object, nullable — Actions that are available to a goal with milestones enabled. This object will not appear on a goal without milestones.
      - `canEditGoalProgressBar` boolean — Can the user edit the progress bar of this goal.
      - `canEditGoalMilestoneProgressBar` boolean — can the user edit the progress of a milestone in this goal.

## Other responses

- `403` — The authenticated caller does not have permission to view goals for this employee.

---

[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)