---
title: "Get task items for an entity"
method: GET
path: "/v1/task-management"
tags: ["Task Management"]
---

# Get task items for an entity

`GET /v1/task-management`

Get task items for an entity in Betayum. Manage task items and attachments linked to operational entities such as risks and vendors.

## Query parameters

- `entityId` string, required
- `entityType` 'vendor' | 'risk', required
- `page` number
- `limit` number
- `status` 'todo' | 'in_progress' | 'in_review' | 'done' | 'canceled'
- `priority` 'urgent' | 'high' | 'medium' | 'low'
- `assigneeId` string
- `sortBy` 'createdAt' | 'updatedAt' | 'title' | 'status' | 'priority'
- `sortOrder` 'asc' | 'desc'

## Response `200`

Task items retrieved successfully

- PaginatedTaskItemResponseDto
  - `data` TaskItemResponseDto[], required — Array of task items
    - `id` string, required — Task item ID
    - `title` string, required — Task title
    - `description` object, nullable, required — Task description
    - `status` 'todo' | 'in_progress' | 'in_review' | 'done' | 'canceled', required — Task status
    - `priority` 'urgent' | 'high' | 'medium' | 'low', required — Task priority
    - `entityId` string, required — ID of the entity this task belongs to
    - `entityType` 'vendor' | 'risk', required — Type of entity
    - `assignee` TaskItemAssigneeDto, required
      - `id` string, required — Member ID
      - `user` object, required — User information
    - `createdBy` TaskItemCreatorDto, required
      - `id` string, required — Member ID
      - `user` object, required — User information
    - `updatedBy` TaskItemUpdaterDto, required
      - `id` string, required — Member ID
      - `user` object, required — User information
    - `createdAt` string, date-time, required — Creation timestamp
    - `updatedAt` string, date-time, required — Last update timestamp
  - `meta` PaginationMetaDto, required
    - `page` number, required — Current page number
    - `limit` number, required — Number of items per page
    - `total` number, required — Total number of items
    - `totalPages` number, required — Total number of pages
    - `hasNextPage` boolean, required — Whether there are more pages
    - `hasPrevPage` boolean, required — Whether there are previous pages

---

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