---
title: "Get Job Status"
method: GET
path: "/api/v1/ingestion/jobs/{ingest_job_id}/status"
tags: ["ingestion > status"]
---

# Get Job Status

`GET /api/v1/ingestion/jobs/{ingest_job_id}/status`

Returns the ingestion status of a job in a dataset.

## Path parameters

- `ingest_job_id` string, required

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

Successful Response

- union
  - IngestionIngestJobStatusResponse
    - `data` IngestionJobStatus, required
      - `status` 'completed' | 'failed' | 'in_progress' | 'pending' | 'paused' | 'stopping' | 'stopped', required — Enum of Ingest Job Status.
      - `assets` IngestionPagedDataResponseStatus
        - `meta` IngestionPagedMetaResponse, required — Metadata about the paginated response
          - `page` IngestionPagedPageDetailsResponse, required — Pagination metadata
            - `current_page` integer, required — Current page number
            - `last_page` integer, nullable, required — Max page number based on limit and total number of items
            - `limit` integer, required — Number of items to return
            - `offset` integer, required — Starting index to return
            - `total` integer, nullable, required — Total number of items
        - `data` IngestionStatus[], required — The paginated data
          - `status` 'pending' | 'in_progress' | 'received' | 'processing_started' | 'completed' | 'error', required
          - `asset_id` string, uuid, required
          - `dataset_id` string, uuid, required
          - `error_code` 'unknown' | 'unknown_content_type' | 'file_not_found' | 'permission_denied' | 'broken_url' | 'file_too_large' | 'video_too_short' | 'video_too_long' | 'resolution_out_of_spec' | 'unsupported_format' | 'unsupported_codec' | 'unsupported_source_type' | 'unsupported_uri_scheme' | 'audio_processing_failed' | 'asset_metadata_error' | 'transcription_failed' | 'composite_creation_failed' | 'composite_slice_creation_failed'
          - `error_reason` string, nullable
          - `source_path` string, nullable
          - `latest_event` IngestionLatestEvent, required
            - `event_type` 'received' | 'assets_enumerated' | 'completed' | 'processing_started' | 'error' | 'kind_determined' | 'stored' | 'metadata_stored' | 'embedding_computed' | 'embedding_stored' | 'asset_copied' | 'timecodes_computed' | 'audio_extracted' | 'audio_processing_started' | 'audio_processing_finished' | 'keyframe_generation_started' | 'keyframe_generation_completed' | 'shot_boundary_detection_started' | 'shot_boundary_detection_completed' | 'file_downloaded' | 'keyframe_generated' | 'transcribed' | 'transcription_segmented' | 'transcripts_created' | 'composite_created' | 'composite_slices_created' — The status-related event that applies to the entity.
            - `event_entity` 'unspecified' | 'request' | 'image' | 'video' | 'audio' | 'shot' | 'visual_keyframe' | 'audio_keyframe' | 'audio_segment' | 'metadata' | 'csv_file' | 'json_file' | 's3_prefix' | 'composite' — The kind of entity that the status event applies to. Determines what collection of IDs show up in the event, e.g.: - request (fewest): - request_id - ingest_job_id - dataset_id - org_id - audio_keyframe (most): - coactive_image_id - coactive_audio_segment_id - coactive_shot_id - coactive_video_id - request_id - ingest_job_id - dataset_id - org_id
            - `timestamp_dt` string, date-time, nullable
          - `asset_type` string, nullable
  - IngestionEmptyResponse
    - `data` unknown[] — Empty data list
      - unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-17** `23dbda5f105c` — 1 breaking, 1 warning, 2 info
  - added `#/components/schemas/ingestion_IngestJobStatusResponse, #/components/schemas/ingestion_EmptyResponse` to the response body `oneOf` list for the response status `200`
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `HTTPBearer` was added to the API
  - removed `#/components/schemas/ingestion:IngestJobStatusResponse, #/components/schemas/ingestion:EmptyResponse` from the response body `oneOf` list for the response status `200`
- **2026-09-12** `3683abf6922b` — 1 info
  - api operation id `get-job-status-api-v-1-ingestion-jobs-ingest-job-id-status-get` removed and replaced with `ingestion_status_get_job_status_api_v1_ingestion_jobs__ingest_job_id__status_get`
- **2026-08-22** `1223758be9ba` — 2 breaking, 3 warning
  - for the `path` request parameter `ingest_job_id`, the minLength was increased from `0` to `24`
  - added the pattern `^[0-9a-f]{24}$` to the `path` request parameter `ingest_job_id`
  - for the `query` request parameter `limit`, the exclusiveMinimum was set to `0.00`
  - for the `path` request parameter `ingest_job_id`, the maxLength was set to `24`
  - …1 more

[Change history](https://skmtc.dev/coactive/apis/api-reference/changes/api/v1/ingestion/jobs/:ingest_job_id/status/get.md)

---

[API](https://skmtc.dev/coactive/apis/api-reference.md) · [All operations](https://skmtc.dev/coactive/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/coactive/apis/api-reference/revisions/23dbda5f105c?raw)