---
title: "List firm tasks · Firm Tasks · Practice Manager API · COUNT Partner API"
description: "Returns a page of the firm’s tasks across every client, with filters. GET /firm-partners/firm/tasks"
canonical: "https://developers.getcount.com/practice-manager/reference/firm-tasks/list-firm-tasks"
source: "https://developers.getcount.com/practice-manager/reference/firm-tasks/list-firm-tasks"
---
[Firm Tasks](https://developers.getcount.com/practice-manager/reference/firm-tasks) / List firm tasks

# List firm tasks

GET `/firm-partners/firm/tasks`

Returns a page of the firm’s tasks across every client, with filters.

Comma-separated filters accept several values. `page` and `limit` are echoed back as you sent them. Needs a key with access to all client workspaces. A key limited to selected client workspaces gets 403 on this route.

HMAC signature only

[Firm, clients & members](https://developers.getcount.com/practice-manager/reference/firm) [Firm projects](https://developers.getcount.com/practice-manager/reference/firm-projects) [Firm time entries](https://developers.getcount.com/practice-manager/reference/firm-time-entries)

#### Query parameters

`page` integer optional

Page number, starting at 1.

`limit` integer optional

Tasks per page. Defaults to 10.

`orderBy` enum optional

Sort field. Defaults to `createdAt`. `client` sorts by workspace name and `assignee` by first name.

One of: `createdAt`, `updatedAt`, `deadlineDate`, `name`, `priority`, `customId`, `project`, `client`, `assignee`

`orderDirection` enum optional

Sort direction. Defaults to `DESC`.

One of: `ASC`, `DESC`

`search` string optional

Case-insensitive match on task name or `customId`.

`customId` string optional

Exact `customId` match, such as `TODO-42`. Can return one task per client workspace, since numbering is per workspace.

`status` string optional

Comma-separated status types: not_started, in_progress, waiting_for_client, blocked, ready_for_review, done, canceled.

`priority` string optional

Comma-separated priorities (high, medium, low). `me` returns open tasks that are high priority, overdue, or due within 48 hours.

`visibility` enum optional

Only tasks with this visibility.

One of: `firm-team`, `team-only`, `firm-only`

`clientWorkspaceUuids` string optional

Comma-separated client workspace ids. Only tasks filed under those workspaces.

`assigneeUuids` string optional

Comma-separated firm member user ids (`user.id` from List firm members).

`assignerUuids` string optional

Comma-separated user ids of the members who assigned the task.

`createdByUuids` string optional

Comma-separated user ids of the members who created the task.

`projectUuids` string optional

Comma-separated project ids from List firm projects.

`overduesOnly` boolean optional

When true, only tasks whose deadline has passed.

`startDeadlineDate` date optional

Deadline on or after this date (YYYY-MM-DD).

`endDeadlineDate` date optional

Deadline on or before this date (YYYY-MM-DD).

`startCreatedAt` date optional

Created on or after this date.

`endCreatedAt` date optional

Created on or before this date.

`startUpdatedAt` date optional

Updated on or after this date.

`endUpdatedAt` date optional

Updated on or before this date.

`source` enum optional

Only tasks an AI agent created, or only tasks people created.

One of: `ai_agent`, `user`

`onlyCounts` boolean optional

When true, returns `count` with an empty `tasks` array.

#### Responses

`200` A page of firm tasks. `count` is the total across all pages.

`400` A member or project filter id is malformed, or a date filter is not a valid date.

`401` Missing signing headers, an invalid HMAC signature, or a timestamp more than 5 minutes off. [Troubleshoot](https://developers.getcount.com/practice-manager/authentication#errors)

`403` The API key is inactive, its scope does not cover this route, or it is limited to selected client workspaces and the route is firm-wide. [Troubleshoot](https://developers.getcount.com/practice-manager/authentication#errors)

`404` A filter names a client workspace, member or project outside the firm, or `clientWorkspaceUuids` is not a valid id.

`429` Rate limit exceeded (100 requests per minute per firm user of each app, or 10,000 per minute per app). [Troubleshoot](https://developers.getcount.com/practice-manager/authentication#errors)

[Next GET Get a firm task](https://developers.getcount.com/practice-manager/reference/firm-tasks/get-firm-task)

GET `https://api.getcount.com/firm-partners/firm/tasks`

Request

```javascript
import crypto from 'node:crypto';

const BASE_URL = 'https://api.getcount.com';
const CLIENT_ID = process.env.COUNT_CLIENT_ID;
const CLIENT_SECRET = process.env.COUNT_CLIENT_SECRET;

const method = 'GET';
const signingPath = '/firm/tasks';
const timestamp = Math.floor(Date.now() / 1000).toString();
const bodyString = '';

const bodyHash = '';
const baseString = `${method}:${signingPath}:${timestamp}:${bodyHash}`;
const signature = crypto.createHmac('sha256', CLIENT_SECRET).update(baseString).digest('hex');

const response = await fetch(`${BASE_URL}/firm-partners/firm/tasks`, {
  method,
  headers: {
    'x-client-id': CLIENT_ID,
    'x-timestamp': timestamp,
    'x-signature': signature,
  },
});

console.log(await response.json());
```

Response · 200

```json
{
  "status": "success",
  "message": "Success on fetching firm tasks.",
  "data": {
    "tasks": [
      {
        "id": "3f4a5b6c-7d8e-4f9a-8b0c-1d2e3f4a5b6c",
        "name": "Q3 sales tax filing",
        "type": "custom",
        "description": "File the California return for Q3.",
        "status": "not_started",
        "priority": "high",
        "visibility": "firm-team",
        "deadlineDate": "2026-10-31T00:00:00.000Z",
        "startDate": null,
        "completedAt": null,
        "customId": "TODO-42",
        "budgetedMinutes": 90,
        "isTimeTrackable": true,
        "totalMinutesTracked": "0",
        "creatorEntity": "accounting-firm",
        "source": null,
        "isFromPeriodClose": false,
        "isFromRecurringSeries": false,
        "isRecurringSourceTask": false,
        "assignedAt": "2026-10-21T10:04:05.000Z",
        "assignee": {
          "id": 5521,
          "firstName": "Dana",
          "lastName": "Okafor",
          "avatarUrl": null
        },
        "assigner": {
          "id": 5510,
          "firstName": "Sam",
          "lastName": "Rivera",
          "avatarUrl": null
        },
        "createdBy": {
          "id": 5510,
          "firstName": "Sam",
          "lastName": "Rivera",
          "avatarUrl": null
        },
        "taskStatus": {
          "id": 311,
          "name": "Not Started",
          "statusType": "not_started",
          "color": "#ACB2BD",
          "order": 0
        },
        "projects": [],
        "team": {
          "id": "5e4d3c2b-1a09-4f8e-8d7c-6b5a49382716",
          "name": "Harbor Coffee Co."
        },
        "createdAt": "2026-10-21T10:04:05.000Z",
        "updatedAt": "2026-10-21T10:04:05.000Z"
      }
    ],
    "filters": {
      "orderBy": "deadlineDate",
      "orderDirection": "ASC"
    },
    "count": 37,
    "page": "1",
    "limit": "20"
  }
}
```
