# goals_list

> Search the caller's goals (KPI targets like "12 closings this quarter" or "get my first subscriber").

<!-- Source: https://docs.actuallycare.com/tools/goals/goals_list -->
<!-- Last updated: 2026-10-22 -->

Search the caller's goals (KPI targets like "12 closings this quarter" or "get my first subscriber"). Returns pagination info (total_count, has_more, offset, limit). Each result includes: id, name, metric, target_value, period_type, period_start, period_end, status, accent, created_at, plus plan progress (plan_done, plan_total, plan_pct) counted from the goal's milestones.

> [!NOTE]
> for the five derived metrics (closings, gci, lead_conversions, appointments, listings_taken) the CURRENT metric value is calculated live by the web app from escrows/leads/appointments/listings and is deliberately NOT returned here — plan progress is. current_value is returned only for metric="manual", where the owner sets the number. Filter by status, metric, or period_type. For one goal plus its milestones, use [`goals_get`](/tools/goals/goals_get).

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | No | Search term — matches against goal name and description (case-insensitive partial match) |
| `status` | enum | No | Filter by status (default: all) · One of: `all`, `active`, `paused`, `achieved`, `missed` |
| `metric` | enum | No | Filter by the metric the goal targets · One of: `closings`, `gci`, `lead_conversions`, `appointments`, `listings_taken`, `manual` |
| `period_type` | enum | No | Filter by period length · One of: `weekly`, `monthly`, `quarterly`, `annually`, `custom` |
| `limit` | number | No | Maximum results (default: 50, max: 500) · Max: 500 · Min: 1 |
| `offset` | number | No | Skip N results for pagination (default: 0) · Min: 0 |

## Example prompts

- "What goals am I working on this quarter?"
- "Show me my paused goals."

## Safety

**Read-only.** This tool never changes your data — it only looks things up. Safe to run anytime.
