List firm tasks
/firm-partners/firm/tasksReturns 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.
Query parameters
pageintegeroptionalPage number, starting at 1.
limitintegeroptionalTasks per page. Defaults to 10.
orderByenumoptionalSort 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
orderDirectionenumoptionalSort direction. Defaults to `DESC`.
One of: ASC, DESC
searchstringoptionalCase-insensitive match on task name or `customId`.
customIdstringoptionalExact `customId` match, such as `TODO-42`. Can return one task per client workspace, since numbering is per workspace.
statusstringoptionalComma-separated status types: not_started, in_progress, waiting_for_client, blocked, ready_for_review, done, canceled.
prioritystringoptionalComma-separated priorities (high, medium, low). `me` returns open tasks that are high priority, overdue, or due within 48 hours.
visibilityenumoptionalOnly tasks with this visibility.
One of: firm-team, team-only, firm-only
clientWorkspaceUuidsstringoptionalComma-separated client workspace ids. Only tasks filed under those workspaces.
assigneeUuidsstringoptionalComma-separated firm member user ids (`user.id` from List firm members).
assignerUuidsstringoptionalComma-separated user ids of the members who assigned the task.
createdByUuidsstringoptionalComma-separated user ids of the members who created the task.
projectUuidsstringoptionalComma-separated project ids from List firm projects.
overduesOnlybooleanoptionalWhen true, only tasks whose deadline has passed.
startDeadlineDatedateoptionalDeadline on or after this date (YYYY-MM-DD).
endDeadlineDatedateoptionalDeadline on or before this date (YYYY-MM-DD).
startCreatedAtdateoptionalCreated on or after this date.
endCreatedAtdateoptionalCreated on or before this date.
startUpdatedAtdateoptionalUpdated on or after this date.
endUpdatedAtdateoptionalUpdated on or before this date.
sourceenumoptionalOnly tasks an AI agent created, or only tasks people created.
One of: ai_agent, user
onlyCountsbooleanoptionalWhen 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. Troubleshoot403The 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. Troubleshoot404A 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). Troubleshoothttps://api.getcount.com/firm-partners/firm/tasksimport 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());{
"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"
}
}