---
title: "Get Jobs Status"
method: GET
path: "/jobs/status"
tags: ["jobs"]
---

# Get Jobs Status

`GET /jobs/status`

## Request

- Base URL: `https://api.framesail.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.framesail.com/jobs/status`
- Auth: HTTP bearer

## Query parameters

- `project_id` string, nullable
- `style_id` string, nullable
- `channel_id` string, nullable

## Response `200`

Successful Response

- JobsStatusResponse
  - `server_time` string, required
  - `jobs` JobStatusRow[], required
    - `id` string, required
    - `job_type` string, required
    - `status` 'pending' | 'running' | 'complete' | 'error', required
    - `resource_type` 'project' | 'script' | 'segment' | 'segment_asset' | 'scene' | 'asset' | 'style' | 'voice_block', required
    - `resource_id` string, required
    - `project_id` string, nullable, required
    - `segment_number` integer, nullable
    - `error_message` string, nullable, required
    - `started_at` string, required
    - `completed_at` string, nullable, required
    - `batch_id` string, nullable
    - `progress` JobProgress: In-flight progress a worker publishes on its own row — see billing.ai_jobs.set_ai_job_progress. `fraction` is 0..1 within `stage`, or None when the stage has nothing measurable.
      - `stage` string, required
      - `fraction` number, nullable
  - `batches` BatchProgress[]
    - `batch_id` string, required
    - `total` integer, required
    - `done` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/framesail/apis/framesail-api.md) · [All operations](https://skmtc.dev/framesail/apis/framesail-api/llms.txt) · [OpenAPI document](https://skmtc.dev/framesail/apis/framesail-api/revisions/12602eae0820?raw)