---
title: "Get a firm task · Firm Tasks · Practice Manager API · COUNT Partner API"
description: "Retrieves one firm task. GET /firm-partners/firm/tasks/{uuid}"
canonical: "https://developers.getcount.com/practice-manager/reference/firm-tasks/get-firm-task"
source: "https://developers.getcount.com/practice-manager/reference/firm-tasks/get-firm-task"
---
[Firm Tasks](https://developers.getcount.com/practice-manager/reference/firm-tasks) / Get a firm task

# Get a firm task

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

Retrieves one firm task.

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)

#### Path parameters

`uuid` uuid required

Firm task UUID.

#### Query parameters

`visibility` enum optional

When set, returns 404 unless the task has this visibility.

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

#### Responses

`200` The firm task.

`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` No task with this UUID belongs to the firm, or it was deleted.

`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)

[Previous GET List firm tasks](https://developers.getcount.com/practice-manager/reference/firm-tasks/list-firm-tasks) [Next POST Create a firm task](https://developers.getcount.com/practice-manager/reference/firm-tasks/create-firm-task)

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

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/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

```json
{
  "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"
    }
  }
}
```
