Firm TasksGet a firm task

Get a firm task

GET/firm-partners/firm/tasks/{uuid}

Retrieves one firm task.

HMAC signature only

Path parameters

uuiduuidrequired

Firm task UUID.

Query parameters

visibilityenumoptional

When 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. 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
404No 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). Troubleshoot
GEThttps://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"
    }
  }
}