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

# List Goal Sharing Options

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

## Request

- Base URL: `https://companySubDomain.bamboohr.com`
- URL: `https://companySubDomain.bamboohr.com/api/v1/performance/employees/{employeeId}/goals/shareOptions`
- 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/shareOptions/get.ts> (a function with typed inputs; its response is checked against the schema)

Provides a list of employees with whom the specified employee\'s goals may be shared.

OAuth Scopes: goal

## Path parameters

- `employeeId` string, required

## Query parameters

- `search` string, required
- `limit` integer

## Response `200`

The response content will be a JSON document with a list of available employees with whom the goals can be shared.

- object
  - `persons` PersonInfoApiTransformer[]: List of employees with whom goals can be shared.
    - `employeeId` integer, nullable: Internal employee ID
    - `userId` integer, nullable: User ID
    - `displayFirstName` string: Display first name
    - `lastName` string: Last name
    - `photoUrl` string: Photo URL

## Other responses

- `400`: The search parameter is invalid or empty.
- `403`: Goals are not enabled, or the authenticated caller does not have permission to view sharing options for this employee.

---

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