---
title: "Annotators report for datasets"
method: GET
path: "/api/v3/teams/{team_slug}/reports/annotator"
tags: ["Reports"]
---

# Annotators report for datasets

`GET /api/v3/teams/{team_slug}/reports/annotator`

Generates an annotators report for a time period


    Note: the report data is available only from 2024-11-05.

## Path parameters

- `team_slug` string, required

## Query parameters

- `metrics[]` ReportAnnotatorMetricItem[], required — Annotator report metrics.
- `user_ids[]` CommonIntegerId[], nullable
- `dataset_ids[]` CommonIntegerId[], nullable
- `start` string, date-time, required — DateTime in RFC3339 format
- `stop` string, date-time, required — DateTime in RFC3339 format
- `group_by[]` ReportGroupBy[], required — Types of grouping.

## Response `200`

Annotator statistics report for specified filters, metrics, date range and grouping

- ReportAnnotatorReport — Annotator Report V3 response information.
  - `annotator_report` ReportAnnotatorReportItem[], required
    - `active_time` integer
    - `actor_email` string
    - `actor_full_name` string
    - `actor_id` integer
    - `actor_type` string
    - `current_stage_id` string, uuid, nullable
    - `current_stage_name` string
    - `current_stage_type` 'annotate' | 'complete' | 'consensus_entrypoint' | 'consensus_test' | 'dataset' | 'discard' | 'model' | 'review' | 'webhook' | 'archive' | 'logic' | 'sampling' | 'parallel_blind' | 'ai_review'
    - `dataset_id` integer
    - `dataset_name` string
    - `dataset_slug` string
    - `review_pass_rate` number, nullable
    - `time_per_annotation` number, nullable
    - `time_per_item` number, nullable
    - `timestamp` string, date-time — DateTime in RFC3339 format
    - `total_annotations` integer
    - `total_items_annotated` integer
    - `workflow_id` string, uuid, nullable
    - `workflow_name` string
  - `annotator_report_aggregates` ReportAnnotatorReportAggregates, required — Annotator Report V3 aggregates response information.
    - `active_time` integer
    - `review_pass_rate` number, nullable
    - `time_per_annotation` number, nullable
    - `time_per_item` number, nullable
    - `total_annotations` integer
    - `total_items_annotated` integer
  - `annotator_report_subaggregates` ReportAnnotatorReportItem[], required
    - `active_time` integer
    - `actor_email` string
    - `actor_full_name` string
    - `actor_id` integer
    - `actor_type` string
    - `current_stage_id` string, uuid, nullable
    - `current_stage_name` string
    - `current_stage_type` 'annotate' | 'complete' | 'consensus_entrypoint' | 'consensus_test' | 'dataset' | 'discard' | 'model' | 'review' | 'webhook' | 'archive' | 'logic' | 'sampling' | 'parallel_blind' | 'ai_review'
    - `dataset_id` integer
    - `dataset_name` string
    - `dataset_slug` string
    - `review_pass_rate` number, nullable
    - `time_per_annotation` number, nullable
    - `time_per_item` number, nullable
    - `timestamp` string, date-time — DateTime in RFC3339 format
    - `total_annotations` integer
    - `total_items_annotated` integer
    - `workflow_id` string, uuid, nullable
    - `workflow_name` string

## Other responses

- `401` — Common.APIError
- `404` — Common.APIError
- `422` — Unprocessible Entity

---

[API](https://skmtc.dev/v7labs/apis/darwin.md) · [All operations](https://skmtc.dev/v7labs/apis/darwin/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/v7labs/darwin/revisions/526a5b6b4cdc/schema)