---
title: "List goals associated with an initiative"
method: GET
path: "/initiatives/{initiative_id}/goals"
tags: ["Goals"]
---

# List goals associated with an initiative

`GET /initiatives/{initiative_id}/goals`

## Request

- Base URL: `https://company.aha.io/api/v1`
- URL: `https://company.aha.io/api/v1/initiatives/{initiative_id}/goals`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://{account-domain}.aha.io/oauth/authorize`
    - Token URL: `https://{account-domain}.aha.io/oauth/token`
  - HTTP bearer
  - API key in cookie `session`
- TypeScript: <https://skmtc.dev/shiprush/apis/aha-api/docs/initiatives/:initiative_id/goals/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `initiative_id` string, required

## Query parameters

- `page` string
- `per_page` string

## Response `200`

Successful operation

- GoalsGetResponse
  - `goals` object[]
    - `id` string
    - `name` string
    - `reference_num` string
    - `effort` integer
    - `value` integer
    - `color` string
    - `position` integer
    - `created_at` string
    - `updated_at` string
    - `product_id` string
    - `progress` unknown
    - `progress_source` string
    - `url` string
    - `resource` string
    - `description` object
      - `id` string
      - `body` string
      - `notable_id` string
      - `notable_type` string
      - `editor_version` string
      - `created_at` string
      - `updated_at` string
      - `attachments` string
    - `success_metric` object
      - `name` string
      - `description` string
      - `workflow_status` string
    - `project` object
      - `id` string
      - `reference_prefix` string
      - `name` string
      - `product_line` string
      - `created_at` string
      - `url` string
      - `workspace_type` string
    - `time_frame` object
      - `id` string
      - `name` string
    - `initiatives` unknown[]
      - unknown
    - `key_results` unknown[]
      - unknown
    - `comments_count` integer
    - `features` unknown[]
      - unknown
    - `releases` unknown[]
      - unknown
    - `custom_fields` unknown[]
      - unknown
  - `pagination` object
    - `total_records` integer
    - `total_pages` integer
    - `current_page` integer

---

[API](https://skmtc.dev/shiprush/apis/aha-api.md) - [All operations](https://skmtc.dev/shiprush/apis/aha-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shiprush/apis/aha-api/revisions/7ac0186e1408?raw)