---
title: "List all report generating jobs"
method: GET
path: "/api/v3/teams/{team_slug}/reports/jobs"
tags: ["Reports"]
---

# List all report generating jobs

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

## Request

- Base URL: `https://darwin.v7labs.com`
- URL: `https://darwin.v7labs.com/api/v3/teams/{team_slug}/reports/jobs`
- Auth: one of:
  - HTTP bearer
  - API key in header `Authorization`

Fetches the info for all existing report generating jobs.

## Path parameters

- `team_slug` string, required

## Query parameters

- `limit` integer, nullable: The maximum number of records to return when using `offset` pagination
- `offset` integer, nullable: The offset to use when paginating records
- `type` 'annotator' | 'item': Report type.
- `dataset_id` integer

## Response `200`

Report.JobList

- ReportJobList: Response for a job list request, containing a page of job items as well as paging information.
  - `data` ReportJobResponse[], required
    - `format` 'csv' | 'json', required: Report format.
    - `id` string, required
    - `inserted_at` string, date-time, required: DateTime in RFC3339 format
    - `owner_id` integer, nullable
    - `status` 'pending' | 'running' | 'finished' | 'failed', required
    - `team_id` integer, required
    - `type` 'annotator' | 'item' | 'storage', required
    - `updated_at` string, date-time, required: DateTime in RFC3339 format
    - `url` string, nullable, required
  - `metadata` PaginationOffsetPaginationMetadata, required: Pagination response metadata for offset-based pagination.
    - `current_offset` integer, nullable: The offset to use when paginating records
    - `has_next_page` boolean: Is there a page after this one.
    - `has_previous_page` boolean: Is there a page before this one.
    - `page_size` integer: The page size or limit of the query. Set to the `first` or `last` parameter when using cursor-based pagination, `limit` when using offset-pased pagination
    - `total_count` integer: Total number of items.

## Other responses

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

## Changes

- **2026-11-03** `9cd7289ca12b`: 31 warning
  - added the new `DUPLICATE_REJECT_REASON` enum value to the `errors/code` response property for the response status `401`
  - added the new `DUPLICATE_REJECT_REASON` enum value to the `errors/code` response property for the response status `404`
  - added the new `DUPLICATE_REJECT_REASON` enum value to the `oneOf[subschema #2: Common.APIError]/errors/code` response property for the response status `422`
  - added the new `EXTERNAL_STORAGE_ACCESS_FAILED` enum value to the `errors/code` response property for the response status `401`
  - …27 more

[Operation history](https://skmtc.dev/v7labs/apis/darwin/changes/api/v3/teams/:team_slug/reports/jobs/get.md)

---

[API](https://skmtc.dev/v7labs/apis/darwin.md) - [All operations](https://skmtc.dev/v7labs/apis/darwin/llms.txt) - [OpenAPI document](https://skmtc.dev/v7labs/apis/darwin/revisions/9cd7289ca12b?raw)