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

# List compliance tasks

`GET /v1/tasks`

List compliance tasks with assignments and status so teams can track audit readiness, evidence work, and control implementation.

## Query parameters

- `includeRelations` string

## Response `200`

Tasks retrieved successfully

- TaskResponseDto[]
  - `id` string, required — Unique identifier for the task
  - `title` string, required — Task title
  - `description` string — Task description
  - `status` 'todo' | 'in_progress' | 'done' | 'blocked', required — Task status
  - `createdAt` string, date-time, required — Task creation timestamp
  - `updatedAt` string, date-time, required — Task last update timestamp
  - `taskTemplateId` object, nullable — Task template ID
  - `integrationScheduleFrequency` 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'yearly', required — Cadence for running the integration check attached to this task
  - `integrationLastRunAt` object, nullable — Last successful integration check run timestamp

## Other responses

- `401` — Unauthorized - Invalid authentication

## Changes

- **2026-04-29** `36253e8a5c1b` — 2 info
  - added the optional property `items/integrationLastRunAt` to the response with the `200` status
  - added the required property `items/integrationScheduleFrequency` to the response with the `200` status
- **2026-03-05** `946edaa856a9` — 1 warning, 1 info
  - deleted the `header` request parameter `X-Organization-Id`
  - added the new optional `query` request parameter `includeRelations`

[Change history](https://skmtc.dev/om-network/apis/betayum-api/changes/v1/tasks/get.md)

---

[API](https://skmtc.dev/om-network/apis/betayum-api.md) · [All operations](https://skmtc.dev/om-network/apis/betayum-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/om-network/betayum-api/revisions/95679a9aa625/schema)