---
title: "List Jobs"
method: GET
path: "/v2/jobs"
tags: ["jobs"]
---

# List Jobs

`GET /v2/jobs`

List your indexing jobs, newest first. Filter by status or collection, and page through results with limit and offset. Use this to see what's currently running, review recent jobs, and check how many files each indexed. For the full detail of a single job, use GET /v2/jobs/{job_id}.

## Query parameters

- `status` 'running' | 'pending' | 'processing' | 'completed' | 'completed_with_errors' | 'failed' | 'cancelled' | 'timed_out' — Filter by job status (running, pending, processing, completed, completed_with_errors, failed, cancelled, timed_out).
- `collection` string, nullable
- `limit` integer
- `offset` integer

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- JobListResponseV2 — A page of your indexing jobs.
  - `jobs` JobSummaryV2[], required
    - `job_id` string, required
    - `status` string, required — running | pending | processing | completed | completed_with_errors | failed | cancelled | timed_out
    - `job_type` string, nullable — The indexing job type, e.g. index_s3, index_gcs_file, index_youtube.
    - `storage_type` string, nullable
    - `collection_name` string, nullable
    - `environment` string, nullable — The environment the job was submitted from: development, staging, or production.
    - `job_name` string, nullable
    - `created_at` string, nullable
    - `finished_at` string, nullable
    - `files_total` integer, nullable
    - `files_indexed` integer, nullable
    - `files_failed` integer, nullable
    - `files_skipped` integer, nullable
    - `error` string, nullable
  - `total_count` integer, required
  - `limit` integer, required
  - `offset` integer, required

## Other responses

- `400` — Invalid status filter
- `401` — Missing or invalid API key

---

[API](https://skmtc.dev/runcaptain/apis/api-reference.md) · [All operations](https://skmtc.dev/runcaptain/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runcaptain/api-reference/revisions/fe4649e3f4aa/schema)