---
title: "Get Video Asset Status"
method: GET
path: "/api/v1/ingestion/videos/{asset_id}/status"
tags: ["ingestion > status"]
---

# Get Video Asset Status

`GET /api/v1/ingestion/videos/{asset_id}/status`

Returns the ingestion status of a video asset.

## Path parameters

- `asset_id` string, uuid, required

## Headers

- `Authorization` string, required

## Response `200`

Successful Response

- union
  - IngestionVideoAssetStatusResponse
    - `data` IngestionStatus, required
      - `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

---

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