list_goals
List and filter all learner goals in your organization by status, claim status, metadata, assigned learner, or inactivity to track progress and identify at-risk learners.
Instructions
List all goals in your org created via the API.
Filter by goal status (draft, in_progress, completed), claim status (unclaimed, claimed, expired, revoked), metadata tags, assigned learner email, or inactivity (at-risk detection).
Use this to see all learner goals, check progress across a cohort, find unused claim links, or identify learners who have gone inactive.
For aggregate cohort metrics, use get_analytics instead.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results to return | |
| offset | No | Pagination offset | |
| status | No | Filter by goal status | |
| category | No | Filter by resource category. Use this to segment ADHD goals from learning goals. | |
| metadata | No | Filter by metadata tag(s) in 'key=value' format. Repeatable for AND logic. E.g. ['track=frontend', 'cohort=spring-2026'] | |
| claim_status | No | Filter by claim link status | |
| inactive_days | No | Return only goals with no step activity in the last N days (at-risk detection) | |
| include_steps | No | Include per-step details (steps[]) for each goal whose plan is ready. Off by default to keep responses lean; set true to render step lists without a get_goal_status call per goal. | |
| assigned_email | No | Return only the goal assigned to this learner email address |