---
updatedAt: 2025-09-22T20:31:35.000Z
agentTools:
  projectIndex: https://docs.v7labs.com/llms.txt
---

# annotators

A CLI how-to guide. SDK power-users can [refer to our full SDK docs generated from our source code here](https://darwin-py-sdk.v7labs.com/)

Prints a report about the annotators and the work they performed in CSV format. Fields present in a report: `timestamp`, `dataset_id`, `dataset_name`, `dataset_slug`, `workflow_id`, `workflow_name`, `current_stage_id`, `current_stage_name`, `actor_id`, `actor_type`, `actor_email`, `actor_full_name`, `active_time`, `total_annotations`, `review_pass_rate`, `total_items_annotated`, `time_per_annotation`, `time_per_item`

Required Arguments:

* `--start 2024-01-20T14:00:00Z`: Report start DateTime in RFC3339 format.
* `--stop 2020-01-20T15:00:00Z`: Report end DateTime in RFC3339 format.
* `--group-by`: Non-empty list of comma-separated grouping options for the report, any of: `datasets`, `stages`, `annotators`.

Optional arguments:

* `--datasets`: Non-empty list of comma-separated dataset slugs to include in the report. All team datasets by default.
* `-r, --pretty`: Prints the results formatted in a rich table.