---
title: "Get a specific frame extraction"
method: GET
path: "/frames/{frame_extraction_id}"
tags: ["Frames"]
---

# Get a specific frame extraction

`GET /frames/{frame_extraction_id}`

## Request

- Base URL: `https://api.cloudglue.dev/v1`
- URL: `https://api.cloudglue.dev/v1/frames/{frame_extraction_id}`
- Auth: HTTP bearer

Retrieve details about a specific frame extraction including its frames

## Path parameters

- `frame_extraction_id` string, uuid, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Frame extraction details

- FrameExtraction
  - `frame_extraction_id` string, uuid, required: Unique identifier for the frame extraction job
  - `status` 'pending' | 'processing' | 'completed' | 'failed', required: Status of the frame extraction job
  - `created_at` number, required: Unix timestamp in milliseconds when the frame extraction was created
  - `file_id` string, uuid, required: ID of the file this frame extraction belongs to
  - `frame_extraction_config` FrameExtractionConfig, required: Configuration for frame extraction. Currently only supports uniform strategy.
    - `strategy` 'uniform', required: Frame extraction strategy - currently only 'uniform' is supported
    - `uniform_config` FrameExtractionUniformConfig: Configuration for uniform frame extraction
      - `frames_per_second` number: Number of frames to extract per second of video
      - `max_width` number: Maximum width of extracted frames in pixels. Aspect ratio is preserved.
    - `thumbnails_config` FrameExtractionThumbnailsConfig: Configuration for frame thumbnails
      - `enable_frame_thumbnails` boolean: Whether to generate CDN-hosted thumbnails for extracted frames
    - `start_time_seconds` number: Optional: The start time of the video in seconds to start extracting frames from
    - `end_time_seconds` number: Optional: The end time of the video in seconds to stop extracting frames at
  - `frame_count` number: Total number of frames extracted (only present when status is completed)
  - `data` object: Frame data with pagination (only present when status is completed and frames exist)
    - `object` 'list', required: Object type, always 'list'
    - `frames` object[]: Array of extracted frames
      - `id` string, uuid, required: Unique identifier for the frame
      - `timestamp` number, required: Timestamp of the frame in seconds
      - `thumbnail_url` string: URL of the CDN-hosted thumbnail for the frame if thumbnails are enabled
    - `total` integer, required: Total number of frames in this extraction
    - `limit` integer, required: Number of frames returned in this response
    - `offset` integer, required: Offset from the start of the frames list

## Other responses

- `404`: Frame extraction not found
- `500`: An unexpected error occurred on the server

## Changes

- **2026-10-30** `23d3f240819f`: 2 info
  - added the optional property `code` to the response with the `404` status
  - added the optional property `code` to the response with the `500` status
- **2026-03-11** `1d5d6115c0d0`: 2 breaking, 3 info
  - for the `query` request parameter `limit`, default value `50` was removed
  - for the `query` request parameter `offset`, default value `0` was removed
  - the `enable_frame_thumbnails` response's property default value `true` was removed for the status `200`
  - the `frames_per_second` response's property default value `1` was removed for the status `200`
  - …1 more
- **2025-10-10** `98ab592d7867`: 1 breaking
  - the response property `frame_extraction_config/thumbnails_config/enable_frame_thumbnails` became optional for the status `200`
- **2025-10-10** `3f3c2cfec49d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cloudglue/apis/cloudglue-api/changes/frames/:frame_extraction_id/get.md)

---

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