---
title: "Получить командные отчёты скрама"
method: GET
path: "/api/v1/tasks/scrum/{project}/reports"
tags: ["Tasks"]
---

# Получить командные отчёты скрама

`GET /api/v1/tasks/scrum/{project}/reports`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/tasks/scrum/{project}/reports`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)
  - HTTP bearer

Только командные числа — сравнений людей нет.

## Response `200`

План и факт по спринтам, velocity и burndown идущего спринта

- ScrumReports
  - `sprints` SprintPoints[], required
    - `sprint` string, uuid, required
    - `name` string, required
    - `status` 'planned' | 'active' | 'completed', required
    - `starts_at` string, nullable, required
    - `ends_at` string, nullable, required
    - `planned_points` integer, nullable, required: План: снимок на старте; у идущего спринта без снимка (начат до оценок в баллах) — текущий объём, тогда plan_fixed = false
    - `completed_points` integer, nullable, required: Факт: снимок на завершении
    - `completed_at` string, nullable, required
    - `plan_fixed` boolean, required: План зафиксирован снимком при старте
    - `scope_points` integer, required: Сумма текущих оценок задач спринта
    - `done_points` integer, required: Сумма текущих оценок задач спринта в «Готово» — текущий факт идущего спринта
    - `added_points` integer, required: Баллы задач, добавленных после старта (журнал объёма)
    - `carried_points` integer, required: Баллы задач, перенесённых при завершении в другой спринт
    - `goal_met` boolean, required: Цель выполнена: спринт завершён, были оценённые задачи и ничего с баллами не перенесено
  - `velocity` Velocity, required: Сколько баллов команда обычно закрывает за спринт — по последним пяти завершённым спринтам. Прогноз — с трёх спринтов истории. Не мерило людей.
    - `sprints` integer, required
    - `average` number, required
    - `min` integer, required
    - `max` integer, required
    - `forecast_low` integer, nullable, required
    - `forecast_high` integer, nullable, required
  - `team` ScrumTeam, required: Командные серии скрама — без мест и сравнения людей
    - `goal_streak` integer, required: Сколько последних завершённых спринтов подряд выполнили цель
    - `velocity_trend` integer[], required: Факт последних (до трёх) завершённых спринтов, от старого к новому
    - `velocity_growing` boolean, required
  - `burndowns` Burndown[], required: Burndown каждого идущего спринта, раньше заканчивающийся — первым
    - `sprint` string, uuid, required
    - `planned_points` integer, required
    - `plan_fixed` boolean, required: false — снимка плана нет: идеальная линия от текущего объёма, журнал в текущих оценках
    - `points` BurndownPoint[], required
      - `date` string, date, required
      - `ideal` number, required
      - `remaining` number, nullable, required: Остаток баллов незавершённых задач; null у будущих дней
      - `scope` number, nullable, required
      - `scope_change` number, required: Баллы, добавленные или убранные за день после старта
  - `burndown` Burndown, required
    - `sprint` string, uuid, required
    - `planned_points` integer, required
    - `plan_fixed` boolean, required: false — снимка плана нет: идеальная линия от текущего объёма, журнал в текущих оценках
    - `points` BurndownPoint[], required
      - `date` string, date, required
      - `ideal` number, required
      - `remaining` number, nullable, required: Остаток баллов незавершённых задач; null у будущих дней
      - `scope` number, nullable, required
      - `scope_change` number, required: Баллы, добавленные или убранные за день после старта

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/a99574d597cc?raw)