---
title: "Find goals"
method: GET
path: "/v1/org/{orgId}/goal"
tags: ["goal"]
---

# Find goals

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

## Path parameters

- `orgId` string, required

## Query parameters

- `personId` string
- `groupId` string
- `personFilter` string
- `originalGoalId` string
- `date` string, date
- `fromId` string
- `limit` integer
- `returnAccess` string

## Response `200`

successful operation

- ResultsGoal
  - `data` Goal[], required
    - `id` string, required — globally unique id
    - `orgId` string, required — parent organization id
    - `status` 'DRAFT' | 'ACTIVE' | 'DONE', required — status
    - `goalTypeId` string, required — goal type
    - `parentGoalId` string — parent goal id, for cascading goals
    - `originalGoalId` string — original goal id, linking this goal to the goal it was copied from
    - `relatedGoalIds` string[] — list of other goals that are related to this goal
    - `ownerPersonIds` string[] — list of persons who are responsible for this goal
    - `supportPersonIds` string[] — list of persons who help support this goal
    - `groupIds` string[] — list of groups who are responsible for this goal
    - `label` string, required — human-readable name of the goal
    - `labelTr` Translations
      - `values` object, required
    - `slug` string, required — url-safe slug for the goal, auto-generated from label if not provided
    - `description` string — human-readable description of the goal
    - `descriptionTr` Translations
      - `values` object, required
    - `startDate` string, date, required — start date for this goal
    - `endDate` string, date, required — end date for this goal
    - `sensitive` 'GLOBAL' | 'ORG' | 'SENSITIVE' | 'PERSONAL' | 'MANAGER' | 'HIGH' | 'PRIVATE', required — sensitivity level of goal
    - `shareAccess` ShareAccess[], required — users who are specifically granted permission to view or edit this goal
      - `access` 'NONE' | 'LIMITED_READ' | 'LIMITED_WRITE' | 'STANDARD_READ' | 'STANDARD_WRITE' | 'COMPENSATION_READ' | 'FULL_READ' | 'COMP_PLANNING_PARTICIPANT' | 'COMPENSATION_WRITE' | 'WRITE' | 'COMPENSATION_OWNER' | 'OWNER', required — access permission level
      - `userId` string — user id
      - `groupId` string — group id
      - `fields` string — fields
    - `progressUpdateConfig` GoalProgressUpdateConfig
      - `schedule` string, required — schedule to send progress reminders, in crontab format
      - `messageChannel` MessageChannelConfig
        - `channels` string[], required
        - `alwaysEmail` boolean, required
      - `message` string — custom message, if any, to include with progress reminders
      - `messageTr` Translations
        - `values` object, required
    - `progressSummary` GoalProgressSummary
      - `id` string
      - `percent` number
      - `confidence` integer
      - `done` integer
      - `progressAt` string
      - `at` string
      - `actuals` GoalTargetActual[]
        - `goalTargetId` string, required
        - `value` union
          - string
          - number
          - boolean
      - `forecasts` GoalProgressForecast[]
        - `goalTargetId` string, required
        - `type` 'WORST' | 'COMMIT' | 'CALL' | 'LIKELY' | 'BEST', required
        - `label` string
        - `value` union, required
          - string
          - number
          - boolean
        - `labelTr` Translations
          - `values` object, required
      - `targetValues` GoalTargetWithValue[]
        - `goalTargetId` string, required
        - `label` string, required
        - `value` union, required
          - string
          - number
          - boolean
        - `color` string
        - `labelTr` Translations
          - `values` object, required
      - `comment` string
    - `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.net/charthop/apis/charthop-api.md) · [All operations](https://skmtc.net/charthop/apis/charthop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/charthop/charthop-api/revisions/50a1edd6b27e/schema)