Get a firm task
GET
/firm-partners/firm/tasks/{uuid}Retrieves one firm task.
HMAC signature only
Path parameters
uuiduuidrequiredFirm task UUID.
Query parameters
visibilityenumoptionalWhen set, returns 404 unless the task has this visibility.
One of: firm-team, team-only, firm-only
Responses
200The firm task.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. Troubleshoot404No task with this UUID belongs to the firm, or it was deleted.429Rate limit exceeded (100 requests per minute per firm user of each app, or 10,000 per minute per app). TroubleshootGET
https://api.getcount.com/firm-partners/firm/tasks/{uuid}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/3f4a5b6c-7d8e-4f9a-8b0c-1d2e3f4a5b6c';
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/3f4a5b6c-7d8e-4f9a-8b0c-1d2e3f4a5b6c`, {
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 task.",
"data": {
"task": {
"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"
}
}
}