---
title: "Find goal targets for a goal"
method: GET
path: "/v1/org/{orgId}/goal/{goalId}/target"
tags: ["goalTarget"]
---

# Find goal targets for a goal

`GET /v1/org/{orgId}/goal/{goalId}/target`

## Request

- Base URL: `https://localhost`
- URL: `https://localhost/v1/org/{orgId}/goal/{goalId}/target`
- Auth: none declared
- TypeScript: <https://skmtc.dev/charthop/apis/charthop-api/docs/v1/org/:orgId/goal/:goalId/target/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `orgId` string, required
- `goalId` string, required

## Query parameters

- `limit` integer
- `returnAccess` string

## Response `200`

successful operation

- ResultsGoalTarget
  - `data` GoalTarget[], required
    - `id` string, required: globally unique id
    - `orgId` string, required: parent organization id
    - `goalId` string, required: goal id that this target belongs to
    - `label` string: human-readable name of the goal target
    - `labelTr` Translations
      - `values` object, required
    - `slug` string: url-safe slug for the goal target, auto-generated from goal slug and label if not provided
    - `startValue` union: starting point value for this target, as-of the date of the goal
      - string
      - number
      - boolean
    - `targetValues` GoalTargetValue[]: potential target values we're working to achieve
      - `targetValueTypeId` string: the type of the target value (for example, 'Stretch' vs 'Minimum'), extracted from the goal type's targetValues
      - `value` union, required: target value to achieve (should be a numeric value, either number, money, or percentage)
        - string
        - number
        - boolean
    - `direction` 'MINIMIZE' | 'MAXIMIZE' | 'TARGET': direction of the target -- whether we want to minimize or maximize the value
    - `type` 'MILESTONE' | 'MONEY' | 'PERCENT' | 'INTEGER' | 'DECIMAL', required: type of the target value
    - `valueExpr` string: Carrot expression used to compute the current value versus target -- if not provided, GoalProgress will be used to track progress
    - `startDate` string, date, required: start date for this goal target
    - `endDate` string, date, required: end date for this goal target
    - `createId` string: created by user id
    - `createBehalfId` string: created on behalf of user id
    - `createAttribution` Attribution
      - `principalUserId` string
      - `agentUserIds` string[]
      - `eventId` string
      - `aiChatId` string
      - `aiToolUseId` string
      - `channel` 'WEB' | 'MOBILE' | 'SLACK' | 'TEAMS' | 'MCP'
    - `createAt` string: created timestamp
    - `updateId` string: last updated by user id
    - `updateBehalfId` string: last updated on behalf of user id
    - `updateAttribution` Attribution
      - `principalUserId` string
      - `agentUserIds` string[]
      - `eventId` string
      - `aiChatId` string
      - `aiToolUseId` string
      - `channel` 'WEB' | 'MOBILE' | 'SLACK' | 'TEAMS' | 'MCP'
    - `updateAt` string: last updated timestamp
    - `deleteId` string: deleted by user id
    - `deleteBehalfId` string: deleted on behalf of user id
    - `deleteAttribution` Attribution
      - `principalUserId` string
      - `agentUserIds` string[]
      - `eventId` string
      - `aiChatId` string
      - `aiToolUseId` string
      - `channel` 'WEB' | 'MOBILE' | 'SLACK' | 'TEAMS' | 'MCP'
    - `deleteAt` string: deleted timestamp
  - `next` string
  - `access` ResultsAccess[]
    - `ids` string[]
    - `allowed` AccessAction[], required
      - `action` string, required
      - `fields` string[]
      - `types` string[]

## Other responses

- `400`: bad request
- `401`: not authorized
- `404`: not found

---

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