Get Task

This endpoint returns one task by ID.

Endpoint

GET /v1/tasks/tasks/:id

Authentication

Include your API key in the x-api-key header. See Authentication.

Required Scope

tasks:read

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	Task ID.

Request Body

This endpoint does not accept a request body.

Example Request

cURL

curl "https://api.crewsum.com/v1/tasks/tasks/task-pqr123stu4567890" \
  -H "x-api-key: $CREWSUM_API_KEY"

JavaScript

const response = await fetch(
  "https://api.crewsum.com/v1/tasks/tasks/task-pqr123stu4567890",
  {
    headers: { "x-api-key": process.env.CREWSUM_API_KEY },
  },
);
const result = await response.json();

HTTP

GET /v1/tasks/tasks/task-pqr123stu4567890 HTTP/1.1
Host: api.crewsum.com
x-api-key: <your-api-key>

Response

On success, the API returns HTTP 200 OK.

Example Response

{
  "message": "Successfully fetched task: task-pqr123stu4567890",
  "data": {
    "id": "task-pqr123stu4567890",
    "name": "Task Name",
    "description": "A brief description of the task",
    "isArchived": false,
    "createdAt": "2026-01-05T15:45:00.000Z",
    "updatedAt": null,
    "clientId": "client-ghi123jkl4567890",
    "projectId": "project-mno123pqr4567890",
    "clientName": "Client Name",
    "projectName": "Project Name",
    "isDeleted": false,
    "clientDeleted": false,
    "projectDeleted": false,
    "isDefault": false,
    "autoAssign": true,
    "projectEndCustomer": "End Customer Name",
    "billingCategory": "BILLABLE",
    "submittedHours": 16
  }
}

Behavior

• Deleted tasks are still returned, with isDeleted: true.
• billingCategory is the parent project’s category when the project has one. Otherwise it is the task’s own category, which can be null.
• isDefault is true for the default task that Crewsum creates with each project.
• projectEndCustomer is the name of the project’s end customer, or null.
• submittedHours is the total of hours on approved timecards for the task.
• hoursBudget is included only when the task has an hours budget.
• updatedAt is null until the task is first updated.
• clientDeleted and projectDeleted are currently always false, even when the client or project is deleted. To check the parent’s state, call Get Project.

Error Responses

Status	Meaning
400	The task ID was missing from the route.
500	Crewsum could not fetch the task, including when no task exists for the ID. The message is Error fetching task: <id>.

Authentication and scope failures are described in Errors.

Related Webhooks

This endpoint does not trigger a webhook.