---
title: "Get task — GanttFather API"
description: "Retrieve a single task, including its assignees and predecessors."
canonical: "https://ganttfather.com/docs/api/get-task/"
locale: "en"
category: "product"
---

# Get task — GanttFather API

API reference [AI assistants (MCP)](https://ganttfather.com/docs/ai-agent/)

## Getting started

- [Introduction](https://ganttfather.com/docs/api/introduction/)
- [Authentication](https://ganttfather.com/docs/api/authentication/)
- [Pagination](https://ganttfather.com/docs/api/pagination/)
- [Rate limits & quotas](https://ganttfather.com/docs/api/rate-limits/)
- [Errors](https://ganttfather.com/docs/api/errors/)

## Projects

- [GET List projects](https://ganttfather.com/docs/api/list-projects/)
- [GET Get project](https://ganttfather.com/docs/api/get-project/)

## Tasks

- [GET List tasks](https://ganttfather.com/docs/api/list-tasks/)
- [GET Get task](https://ganttfather.com/docs/api/get-task/)
- [POST Create task](https://ganttfather.com/docs/api/create-task/)
- [PATCH Update task](https://ganttfather.com/docs/api/update-task/)
- [DELETE Delete task](https://ganttfather.com/docs/api/delete-task/)
- [POST Reorder tasks](https://ganttfather.com/docs/api/reorder-tasks/)
- [PUT Set assignees](https://ganttfather.com/docs/api/set-assignees/)

## Dependencies

- [GET List dependencies](https://ganttfather.com/docs/api/list-dependencies/)
- [PUT Set dependencies](https://ganttfather.com/docs/api/set-dependencies/)
- [POST Add dependency](https://ganttfather.com/docs/api/add-dependency/)
- [DELETE Remove dependency](https://ganttfather.com/docs/api/remove-dependency/)

## Resources

- [GET List resources](https://ganttfather.com/docs/api/list-resources/)
- [POST Create resource](https://ganttfather.com/docs/api/create-resource/)
- [PATCH Update resource](https://ganttfather.com/docs/api/update-resource/)
- [DELETE Delete resource](https://ganttfather.com/docs/api/delete-resource/)

## Members

- [GET List members](https://ganttfather.com/docs/api/list-members/)

 Tasks / **Get task**

# Get task

 GET

 Updated Jul 4, 2026

 Returns one task by id, including assigneeIds and predecessors — the two relations that [List tasks](https://ganttfather.com/docs/api/list-tasks/) omits.

 A task your token can’t reach answers 404 — never 403 — since a foreign id looks identical to a nonexistent one. See [Authentication →](https://ganttfather.com/docs/api/authentication/) for the full denial contract.

## Path parameters

 Name Type Required Description

 taskId string (uuid) Yes The task to retrieve.

## Response fields

 Name Type Description

 id string (uuid) Stable task identifier.

 name string Task name as shown in the timeline.

 description string or null Optional task description.

 startDate / endDate string (ISO 8601) Scheduled window, returned with its UTC offset.

 estimation number or null Optional task estimate.

 progress integer Completion percentage from 0 to 100.

 status string Current workflow status.

 statusKey string or null Optional custom workflow status key.

 priority string Current task priority.

 orderIndex number Sort position within the project.

 indentation integer Hierarchy depth in the task tree.

 parentId string (uuid) or null Parent task identifier, when nested.

 assigneeIds array of UUIDs Project member or resource identifiers assigned to the task.

 predecessors array of objects Dependency edges, including predecessor id, type, and lag.

 curl https://api.ganttfather.com/v1/tasks/{taskId} \
 -H "Authorization: Bearer glt_YOUR_TOKEN"

 Response 200 OK

 {
 "id": "0198f1a2-6b3d-7c9e-9a1f-2d4e5f6a7b8c",
 "name": "Draft launch checklist",
 "description": "Confirm every workstream owner before the freeze.",
 "startDate": "2026-07-07T00:00:00Z",
 "endDate": "2026-07-10T00:00:00Z",
 "estimation": 8,
 "progress": 25,
 "status": "InProgress",
 "statusKey": null,
 "priority": "Medium",
 "orderIndex": 1000,
 "indentation": 0,
 "parentId": null,
 "assigneeIds": ["0198f1a2-1111-7c9e-9a1f-2d4e5f6a7b8c"],
 "predecessors": [
 { "predecessorId": "0198f1a2-2222-7c9e-9a1f-2d4e5f6a7b8c", "type": "FS", "lag": 0 }
 ]
}

 Rather not write REST?

## Connect an AI assistant instead.

 [Explore MCP setup →](https://ganttfather.com/docs/ai-agent/)