---
title: "List goals"
method: GET
path: "/goals"
tags: ["Goals"]
---

# List goals

`GET /goals`

List financial goals with optional status filter.

## Query parameters

- `status` 'active' | 'paused' | 'completed' | 'cancelled'

## Response `200`

Goals retrieved.

- object
  - `data` object, required
    - `goals` object[], required
      - `id` string, required
      - `name` string, required
      - `goal_type` string, required
      - `status` string, required
      - `target_amount` number, nullable, required
      - `current_value` number, nullable, required
      - `target_date` string, nullable, required
  - `meta` object, required
    - `request_id` string, required
    - `timestamp` string, date-time, required

---

[API](https://skmtc.net/yoshi-ai-dev/apis/yoshi-api.md) · [All operations](https://skmtc.net/yoshi-ai-dev/apis/yoshi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yoshi-ai-dev/yoshi-api/revisions/79b8247d58a2/schema)