---
title: "Get the configured questions (hydrated with text) for a goal's progress updates, by phase"
method: GET
path: "/v1/org/{orgId}/goal/{goalId}/question"
tags: ["goal"]
---

# Get the configured questions (hydrated with text) for a goal's progress updates, by phase

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

## Request

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

## Path parameters

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

## Query parameters

- `phase` 'FIRST' | 'UPDATE' | 'DONE'

## Response `200`

successful operation

- GoalQuestionInfo[]
  - `id` string, required
  - `phase` 'FIRST' | 'UPDATE' | 'DONE', required
  - `required` boolean
  - `question` string, required
  - `questionTr` Translations
    - `values` object, required
  - `type` 'ADDRESS' | 'ALLOCATIONS' | 'AUDIO' | 'BOOLEAN' | 'COMP' | 'COMPOUND' | 'COMP_BAND' | 'CONTACTS' | 'CURRENCY' | 'DATE' | 'DECIMAL' | 'ELAPSED_DAYS' | 'ELAPSED_MONTHS' | 'ELAPSED_YEARS' | 'EMAIL' | 'ENUM' | 'ENUM_EXPR' | 'ENUM_MULTI' | 'ENUM_SCALE' | 'EXPR' | 'FILE' | 'GROUP' | 'GROUPS' | 'GROUP_ASSIGNMENTS' | 'GROUP_TYPE' | 'GROUP_POSITION_ASSIGNMENTS' | 'IMAGE' | 'INTEGER' | 'JOB' | 'JOB_CODE' | 'JOBS' | 'JOB_TIER' | 'LIST' | 'MAP' | 'MONEY' | 'NAME' | 'OBJECT' | 'PAY_INTERVAL' | 'PERCENT' | 'PERSON' | 'PERSONS' | 'PHONE' | 'STOCKGRANT' | 'STRING' | 'TABLE_REF' | 'TEXT' | 'TIMEOFF' | 'TIMESTAMP' | 'TRACKED_GROUP' | 'URL' | 'USER' | 'VARIABLE_COMP' | 'VARIABLE_COMPS', required
  - `plural` 'SINGLE' | 'LIST' | 'SET', required
  - `values` EnumValue[]
    - `name` string, required: enum value name
    - `label` string, required: enum value label
    - `color` string: color of property
    - `expr` string: computed expression, for ENUM_EXPR type
    - `num` number: numeric value, for ENUM_SCALE type
    - `sort` integer: sort order
    - `rank` integer: rank order, if selected in rank order
    - `id` string: unique identifier for enum
    - `labelTr` Translations
      - `values` object, required
  - `options` FieldOptions, required
    - `min` string: minimum value, for numeric and date fields
    - `max` string: maximum value, for numeric and date fields
    - `minItems` integer
    - `maxItems` integer
    - `stackRank` boolean
    - `step` number
    - `enableEditDialog` boolean
    - `requiredJobField` boolean
    - `excludeTargetPersonId` boolean
    - `maxLength` integer
    - `readOnly` boolean
    - `includeFormer` boolean
    - `groupTypeIds` string[]: group types whose groups may be selected, for GROUP fields
    - `effectiveDated` boolean
    - `unique` boolean
    - `required` boolean

## Other responses

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

## Changes

- **2026-10-28** `f52dc2b33e8f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/charthop/apis/charthop-api/changes/v1/org/:orgId/goal/:goalId/question/get.md)

---

[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/c4ab2e4f2575?raw)