# Track progress against a goal

> Report how a Dailybot goal is going: goals with progress and projects, the is_partial flag, and the open work behind a goal.

Language: en
Canonical: https://www.dailybot.com/developers/plan/recipes/goal-progress
Markdown: send header `Accept: text/markdown` on any URL to receive Markdown instead of HTML.
Last Updated: 2026-09-25

---

> **Beta** — Plan is in beta. Everything under `/plan` in the web app, the CLI and agent skill commands for projects, goals, boards and tasks, and the `/v1/plan/` public API may change before general availability. Want to try it with your team? Write to **support@dailybot.com**.

A goal says what the work is for; the tasks under its projects say how it is going. This recipe builds a goal status report: every goal active today with its progress, then the open work behind one of them.

<h2 id="list">1. Goals active today, with progress</h2>

```bash
curl -sS "https://api.dailybot.com/v1/plan/goals/?active_on=$(date +%F)&include=progress,projects" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN" \
  | jq '.results[] | {name, status, done: .progress.completed, total: .progress.total, percent: .progress.percent_complete, partial: .progress.is_partial}'
```

- `active_on` keeps goals whose period covers that date.
- `include=progress,projects` adds the progress roll-up and the linked projects. They are absent by default because each is an aggregate; an unknown token is `400 invalid_filter_value`.
- `status` is the goal's **declared** status (`on_track`, `at_risk`, …); `progress` is **measured** from tasks. Show both.

From the CLI:

```bash
dailybot plan goal list --include progress --include projects
```

<h2 id="one-goal">2. One goal in detail</h2>

The detail endpoint always includes `progress`, `projects` and `project_count`:

```bash
curl -sS "https://api.dailybot.com/v1/plan/goals/$GOAL/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"
```

```json
{
  "uuid": "00000000-0000-4000-8000-000000000006",
  "name": "Q4 Roadmap",
  "status": "on_track",
  "period_start": "2026-10-01",
  "period_end": "2026-12-31",
  "progress": { "total": 40, "completed": 18, "open": 22, "blocked": 3, "overdue": 2, "percent_complete": 45, "is_partial": true },
  "project_count": 2,
  "projects": [ { "uuid": "00000000-0000-4000-8000-000000000001", "name": "Platform", "health": "on_track" } ]
}
```

From the CLI:

```bash
dailybot plan goal get "$GOAL"
```

<h2 id="partial">3. Respect is_partial</h2>

**Progress counts only the tasks you can see.** When some of the goal's work sits on boards you cannot see, `is_partial` is `true`. Say so wherever you show the number, for example "45% of the work visible to you". Never present it as the organization's progress.

<h2 id="open-work">4. The open work behind the goal</h2>

The task list's `goal` filter matches a task's own goal, or the goal it inherits from its project, the same rule the progress roll-up uses, so the list and the numbers agree:

```bash
curl -sS "https://api.dailybot.com/v1/plan/tasks/?goal=$GOAL&state=open&sort=due_date" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN" | jq '.results[] | {key, title, due_date, state: .state.name}'
```

Add `&blocked=true` for what is stuck, or `&due_before=$(date +%F)` for what is late.

<h2 id="reference">Reference</h2>

- [`GET /v1/plan/goals/`](/developers/api/plan-goals#plan-goals-list) and [`GET /v1/plan/goals/{goal_id}/`](/developers/api/plan-goals#plan-goal-get)
- [`GET /v1/plan/tasks/`](/developers/api/plan-tasks#plan-tasks-list)
- [Goals in the overview](/developers/plan#goals)

---

## Developer portal navigation

**Getting Started**

- [Overview](/developers)
- [Quick start](/developers/getting-started)
- [Authentication](/developers/authentication)

**API Reference**

- [API Overview](/developers/api)
- [Users](/developers/api/users)
- [Organization](/developers/api/organization)
- [Teams](/developers/api/teams)
- [Invitations](/developers/api/invitations)
- [Check-ins](/developers/api/check-ins)
- [Forms](/developers/api/forms)
- [Labels](/developers/api/labels)
- [Report channels](/developers/api/report-channels)
- [Templates](/developers/api/templates)
- [Kudos](/developers/api/kudos)
- [Mood tracking](/developers/api/mood)
- [Important dates](/developers/api/important-dates)
- [Messaging](/developers/api/messaging)
- [Automations](/developers/api/workflows)
- [Webhooks](/developers/api/webhooks)
- [Commands platform](/developers/api/commands-platform)
- [Agents](/developers/api/agents)
- [OAuth2](/developers/api/oauth2)
- [Integrations](/developers/api/integrations)
- [CLI](/developers/api/cli)
- [Plan · Projects](/developers/api/plan-projects)
- [Plan · Goals](/developers/api/plan-goals)
- [Plan · Boards](/developers/api/plan-boards)
- [Plan · Tasks](/developers/api/plan-tasks)
- [Plan · Comments & files](/developers/api/plan-collaboration)
- [Plan · Home & search](/developers/api/plan-home)
- [Plan · Notifications & reports](/developers/api/plan-notifications)

**Dailybot Plan**

- [Overview](/developers/plan)
- [Concepts](/developers/plan/concepts)
- [Quickstart](/developers/plan/quickstart)
- [Authentication & scopes](/developers/plan/authentication)
- [Agents on Plan](/developers/plan/agents)
- [Conventions](/developers/plan/conventions)
- [Errors](/developers/plan/errors)
- [CLI for Plan](/developers/plan/cli)
- [Agent skill](/developers/plan/agent-skill)
- [Recipe: live board](/developers/plan/recipes/board-live-updates)
- [Recipe: home in one request](/developers/plan/recipes/home-in-one-request)
- [Recipe: bulk create](/developers/plan/recipes/bulk-create)
- [Recipe: move on PR merge](/developers/plan/recipes/move-on-pr-merge)
- [Recipe: goal progress](/developers/plan/recipes/goal-progress) (this page)
- [Recipe: webhooks](/developers/plan/recipes/webhooks)

**API guides**

- [Errors & Status Codes](/developers/errors)
- [Rate Limits](/developers/rate-limits)
- [Conventions](/developers/conventions)
- [API Changelog](/developers/api-changelog)
- [Recipes](/developers/recipes)

**Developer Features**

- [Custom commands](/developers/custom-commands)
- [Serverless commands](/developers/serverless)
- [Webhooks & events](/developers/webhooks)
- [Automation API trigger](/developers/workflow-trigger)
- [Activity API](/developers/activity-api)

**CLI**

- [Overview](/developers/cli)
- [Authentication](/developers/cli-authentication)
- [Command reference](/developers/cli-reference)
- [CI/CD recipes](/developers/cli-ci-cd)
- [Configuration](/developers/cli-configuration)
- [Troubleshooting](/developers/cli-troubleshooting)

**Agent Skill**

- [Overview](/developers/agent-skill)
- [Skills catalog](/skills)

---

## Site navigation

**Product:**
- [Home](/)
- [Product](/product)
- [Pricing](/pricing)
- [Enterprise](/enterprise)
- [Integrations](/integrations)
- [Templates](/templates)

**Resources:**
- [Blog](/blog)
- [Academy](/academy)
- [Changelog](/changelog)
- [Help Center](/help)
- [Developers](/developers)
- [Agents](/agents)

**Company:**
- [About](/about)
- [Careers](/careers)
- [Security](/security)
- [Contact Sales](/demo)

**Connect:**
- [LinkedIn](https://www.linkedin.com/company/dailybot/)
- [X/Twitter](https://twitter.com/dailybot)
- [GitHub](https://github.com/Dailybot-Inc)
- [YouTube](https://www.youtube.com/channel/UC3uM9V52vwX7e3vQpCc4qvA)

