---
title: "Get a task by id"
method: GET
path: "/tasks/{taskId}"
tags: ["Tasks"]
---

# Get a task by id

`GET /tasks/{taskId}`

## Request

- Base URL: `https://api3.autarc.energy/v1`
- URL: `https://api3.autarc.energy/v1/tasks/{taskId}`
- Auth: API key in header `X-Api-Key`

## Path parameters

- `taskId` string, uuid, required

## Response `200`

One task

- Task: A to-do in the company, optionally tied to a project or customer and assigned to a team member.
  - `id` string, uuid, required
  - `title` string, required
  - `description` string, nullable
  - `status` 'pending' | 'in_progress' | 'completed', required
  - `priority` 'urgent' | 'high' | 'medium' | 'low' | 'none', required
  - `dueAt` string, date-time, nullable
  - `projectId` string, uuid, nullable
  - `customerId` string, uuid, nullable
  - `profileId` string, uuid, nullable: The team member the task is assigned to.
  - `createdByProfileId` string, uuid, nullable
  - `companyId` string, uuid, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400`: Invalid request — a malformed id, filter, pagination parameter or body. The body is a plain-text message naming the problem.
- `404`: The specified resource was not found

---

[API](https://skmtc.dev/autarc/apis/autarc-2-0-api.md) - [All operations](https://skmtc.dev/autarc/apis/autarc-2-0-api/llms.txt) - [OpenAPI document](https://skmtc.dev/autarc/apis/autarc-2-0-api/revisions/adfb20a40efc?raw)