---
title: "Get File Frames"
method: GET
path: "/v2/files/{file_uuid}/frames"
tags: ["Files"]
---

# Get File Frames

`GET /v2/files/{file_uuid}/frames`

Get download URLs for all extracted frames from a video file.

Only available for video files after processing completes. Check processing status
with GET /files/{file_uuid}/status first.

Args:
    file_uuid (str): UUID of the video file.

Returns:
    FileFramesResponse: Contains:
        - frame_urls: List of URLs to access each frame (sorted by frame number)
        - frame_count: Total number of frames available

    Each frame URL is valid for 30 minutes. Use these URLs to download or display
    individual video frames for analysis.

Raises:
    AymaraAPIError:
        - If file is not a video (use file_type field to check)
        - If processing not complete (check processing_status first)

Example:
    GET /api/v2/files/{file_uuid}/frames

## Path parameters

- `file_uuid` string, required

## Response `200`

OK

- FileFramesResponse — Schema for video file frames endpoint.
  - `file_uuid` string, required — Unique identifier for the file.
  - `frame_urls` string[], required — List of presigned URLs to video frames, sorted by frame number.
  - `frame_count` integer, required — Total number of frames available.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/aymara-ai/apis/aymara-api.md) · [All operations](https://skmtc.net/aymara-ai/apis/aymara-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aymara-ai/aymara-api/revisions/0cb64ef11adf/schema)