---
title: "Get a task by id, with the record it hangs off. A task whose record has been deleted is treated as not existing."
method: GET
path: "/api/tasks/{id}"
tags: ["Task"]
---

# Get a task by id, with the record it hangs off. A task whose record has been deleted is treated as not existing.

`GET /api/tasks/{id}`

## Path parameters

- `id` string, required

## Response `200`

The task for the given id

- TaskDto — One task, with enough of the record it hangs off to identify it.
  - `id` string, nullable — The id of the task
  - `relatedRecord` TaskRelatedRecordDto — The record a task hangs off. Every task currently hangs off a change order.
    - `id` string, nullable — The id of the record, as returned by Change Order List
    - `number` integer, nullable — The record's sequential number. Read-only
    - `customer` CommonReferenceDto — Represents a reference to a document in a DB collection
      - `id` string, nullable — Unique Id associated to the referenced object
      - `name` string, nullable — Descriptive name associated to the object
  - `title` string, nullable — What the task is
  - `description` string, nullable — A longer description of the task
  - `notes` string, nullable — Free-text notes on the task
  - `sequence` integer — The step the task sits at within its record's task list. Tasks sharing a step are parallel work, so a step is not unique within a record
  - `taskGroup` CommonReferenceDto — Represents a reference to a document in a DB collection
    - `id` string, nullable — Unique Id associated to the referenced object
    - `name` string, nullable — Descriptive name associated to the object
  - `assignedTo` CommonReferenceDto — Represents a reference to a document in a DB collection
    - `id` string, nullable — Unique Id associated to the referenced object
    - `name` string, nullable — Descriptive name associated to the object
  - `dueDateUtc` string, date-time, nullable — When the task is due (UTC), or null when it carries no date
  - `complete` boolean — Whether the task is complete
  - `completedUtc` string, date-time, nullable — When the task was completed (UTC). Server-stamped when the task is first marked complete and cleared when it is re-opened. Read-only
  - `completedBy` CommonReferenceDto — Represents a reference to a document in a DB collection
    - `id` string, nullable — Unique Id associated to the referenced object
    - `name` string, nullable — Descriptive name associated to the object
  - `attachmentCount` integer — How many attachments the task carries
  - `lastNotification` TaskNotificationDto — The message that went out for a task step: who was told, over which channel, and when.
    - `userId` string, nullable — The id of the user who was told
    - `userName` string, nullable — The name of the user who was told
    - `channel` 'none' | 'email' | 'slack' | 'teams' | 'gChat' — How a task notification was delivered.
    - `sentUtc` string, date-time — When the message was handed to the sender (UTC). Delivery itself is not tracked

## Other responses

- `404` — Task did not exist

## Changes

- **2026-09-26** `e584a13d530a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/changes/api/tasks/:id/get.md)

---

[API](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi.md) · [All operations](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/llms.txt) · [OpenAPI document](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/revisions/e584a13d530a?raw)