Firm TasksList 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

Query parameters

pageintegeroptional

Page number, starting at 1.

limitintegeroptional

Tasks per page. Defaults to 10.

orderByenumoptional

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

orderDirectionenumoptional

Sort direction. Defaults to `DESC`.

One of: ASC, DESC

searchstringoptional

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

customIdstringoptional

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

statusstringoptional

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

prioritystringoptional

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

visibilityenumoptional

Only tasks with this visibility.

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

clientWorkspaceUuidsstringoptional

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

assigneeUuidsstringoptional

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

assignerUuidsstringoptional

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

createdByUuidsstringoptional

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

projectUuidsstringoptional

Comma-separated project ids from List firm projects.

overduesOnlybooleanoptional

When true, only tasks whose deadline has passed.

startDeadlineDatedateoptional

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

endDeadlineDatedateoptional

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

startCreatedAtdateoptional

Created on or after this date.

endCreatedAtdateoptional

Created on or before this date.

startUpdatedAtdateoptional

Updated on or after this date.

endUpdatedAtdateoptional

Updated on or before this date.

sourceenumoptional

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

One of: ai_agent, user

onlyCountsbooleanoptional

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

Responses

200A page of firm tasks. `count` is the total across all pages.
400A member or project filter id is malformed, or a date filter is not a valid date.
401Missing signing headers, an invalid HMAC signature, or a timestamp more than 5 minutes off. Troubleshoot
403The 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
404A filter names a client workspace, member or project outside the firm, or `clientWorkspaceUuids` is not a valid id.
429Rate limit exceeded (100 requests per minute per firm user of each app, or 10,000 per minute per app). Troubleshoot
GEThttps://api.getcount.com/firm-partners/firm/tasks
Request
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
{
  "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"
  }
}