---
title: "Get team tasks"
method: POST
path: "/tasks/team"
tags: ["task"]
---

# Get team tasks

`POST /tasks/team`

Retrieves tasks for your team based on the provided filters.

**Permission:** No specific permission required. A valid API key is sufficient.

**Monitoring:** No impact.

## Request body

- TeamTaskRequest
  - `type` string
  - `status` string[]
  - `group_ids` integer[]
  - `user_ids` integer[]
  - `creation_date_start` string
  - `creation_date_end` string
  - `limit_count` integer
  - `limit_offset` integer
  - `order_by` string
  - `order_direction` string

## Response `200`

Successful operation — returns the list of matching tasks.

- Task[]
  - `teamId` integer
  - `userId` integer
  - `type_id` integer
  - `data` string, nullable
  - `details` string, nullable
  - `type` string, nullable
  - `priority` integer
  - `createdBy` integer
  - `status` string, nullable
  - `scheduledDate` string, date-time
  - `deletionDate` string, date-time

## Other responses

- `400` — Bad request — invalid filter parameters.
- `401` — Unauthorized — missing or invalid token.
- `403` — Forbidden — user is not part of your team or caller is not technical.
- `500` — Internal server error.

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)