---
title: "List In Flight Import Jobs"
method: GET
path: "/api/v1/import/jobs/in-flight"
tags: ["import"]
---

# List In Flight Import Jobs

`GET /api/v1/import/jobs/in-flight`

The caller's running imports — the safety net under the SSE progress feed.

Polled on a slow cadence only while something is in flight, mirroring the
enrichment equivalent, because the publish path swallows its own failures.
Never selects ``working_set``: that column is tens of KB per row and
inlining it here would detoast every job on every poll.

Reclaims stranded rows first. This read is where "still working" is
believed, so it is also where a run nobody is working on has to stop being
believed — a lazy fallback at the consumer rather than a sweep, since the
poll only runs while a client thinks something is in flight.

## Response `200`

Successful Response

- ImportJobsResponse — The in-flight set for one user, mirroring the enrichment safety-net poll.
  - `jobs` ImportJobResponse[], required
    - `id` string, uuid, required
    - `project_id` string, uuid, required
    - `status` 'pending' | 'running' | 'cancelling' | 'completed' | 'failed' — Lifecycle of one background import. - PENDING: row inserted, workflow enqueued, no chunk resolved yet - RUNNING: the workflow claimed the job and is resolving chunks - CANCELLING: the user asked to stop; the workflow observes this at the next chunk boundary and falls through to a normal finalize. Cancel is cooperative, so this is an in-flight state, not a terminal one — the partial commit still has to happen. - COMPLETED: finalized, whether every row resolved or only some - FAILED: finalized with nothing committed, or the workflow raised
    - `total_rows` integer
    - `resolved_rows` integer
    - `committed_rows` integer
    - `shortfall_rows` integer
    - `failure_reason` string, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable

---

[API](https://skmtc.net/maia-analytics/apis/maia-api.md) · [All operations](https://skmtc.net/maia-analytics/apis/maia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maia-analytics/maia-api/versions/ba2b8d962161/schema)
