---
title: "Task Counts"
method: GET
path: "/api/v1/tasks/counts"
---

# Task Counts

`GET /api/v1/tasks/counts`

Return task counts per status without serialising task bodies.

This is the lightweight alternative to GET /tasks for orchestrator
tick summaries and dashboard polling.

## Query parameters

- `tenant` string, nullable

## Response `200`

Successful Response

- TaskCountsResponse — Lightweight status counts - no task bodies. Every value in :class:`bernstein.core.tasks.models.TaskStatus` is exposed as a field so the GUI's status-chip badges can render real numbers instead of ``-``. Adding fields here is non-breaking - existing clients that consume only ``open``/``claimed``/``done`` continue to work and the new fields default to ``0``.
  - `open` integer
  - `claimed` integer
  - `in_progress` integer
  - `done` integer
  - `closed` integer
  - `failed` integer
  - `blocked` integer
  - `cancelled` integer
  - `planned` integer
  - `pending_approval` integer
  - `waiting_for_subtasks` integer
  - `orphaned` integer
  - `abandoned` integer
  - `blocked_by_abandon` integer
  - `blocked_by_failed_dep` integer
  - `refused` integer
  - `suspended` integer
  - `total` integer

## Other responses

- `403` — Tenant scope access denied
- `404` — Resource not found or tenant mismatch
- `422` — Validation Error

## Changes

> 15 revisions in range; 5 could not be searched.

- **2026-07-26** `2a1299ef19fa` — 12 info
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the optional property `abandoned` to the response with the `200` status
  - added the optional property `blocked_by_abandon` to the response with the `200` status
  - …8 more

[Change history](https://skmtc.dev/sipyourdrink-ltd/apis/bernstein-task-server/changes/api/v1/tasks/counts/get.md)

---

[API](https://skmtc.dev/sipyourdrink-ltd/apis/bernstein-task-server.md) · [All operations](https://skmtc.dev/sipyourdrink-ltd/apis/bernstein-task-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sipyourdrink-ltd/bernstein-task-server/revisions/7f4871ff054a/schema)