---
title: "List tasks"
method: GET
path: "/tasks"
tags: ["Tasks"]
---

# List tasks

`GET /tasks`

## Request

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

Returns the company's tasks, newest first. Filters combine with AND.

## Query parameters

- `page` integer
- `limit` integer
- `projectId` string, uuid
- `customerId` string, uuid
- `profileId` string, uuid
- `status` 'pending' | 'in_progress' | 'completed'
- `priority` 'urgent' | 'high' | 'medium' | 'low' | 'none'

## Response `200`

A page of tasks

- object
  - `items` Task[], required
    - `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
  - `metadata` ListMetadata, required: Paging block of the public API's list envelope.
    - `page` integer, required: Current page number (1-based)
    - `limit` integer, required: Number of items per page
    - `total` integer, required: Total number of matching items across all pages

## Other responses

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

---

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