---
title: "Get thumbnails for a file"
method: GET
path: "/files/{file_id}/thumbnails"
tags: ["Files", "Thumbnails"]
---

# Get thumbnails for a file

`GET /files/{file_id}/thumbnails`

## Request

- Base URL: `https://api.cloudglue.dev/v1`
- URL: `https://api.cloudglue.dev/v1/files/{file_id}/thumbnails`
- Auth: HTTP bearer

Get all thumbnails for a file

## Path parameters

- `file_id` string, uuid, required

## Query parameters

- `is_default` boolean
- `segmentation_id` string, uuid
- `limit` integer
- `offset` integer
- `type` string: The type of the thumbnail: 'segment' for segment thumbnails, 'keyframe' for keyframes, 'file' for file thumbnails, 'frame' for frame thumbnails. Comma separated string of one or more types.

## Response `200`

List of thumbnails

- ThumbnailList
  - `object` 'list', required: Object type, always 'list'
  - `total` integer, required: Total number of segmentations matching the query
  - `limit` integer, required: Number of items returned in this response
  - `offset` integer, required: Offset from the start of the list
  - `data` Thumbnail[], required
    - `id` string, uuid, required: The ID of the thumbnail
    - `url` string, required: The URL of the thumbnail
    - `time` number, required: The time of the thumbnail in seconds relative to the start of the video
    - `segmentation_id` string, uuid: The ID of the segmentation if part of a segmentation job
    - `type` string: The type of the thumbnail: 'segment' for segment thumbnails, 'keyframe' for keyframes, 'file' for file thumbnails, 'frame' for frame thumbnails. Comma separated string of one or more types.
    - `segment_id` string, uuid: The ID of the segment if part of a segmentation job

## Other responses

- `404`: File 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`: 3 breaking
  - for the `query` request parameter `is_default`, default value `false` was removed
  - for the `query` request parameter `limit`, default value `50` was removed
  - for the `query` request parameter `offset`, default value `0` was removed
- **2025-12-12** `89641a9d6eb2`: 2 info
  - added the new optional `query` request parameter `type`
  - added the optional property `data/items/type` to the response with the `200` status

[Operation history](https://skmtc.dev/cloudglue/apis/cloudglue-api/changes/files/:file_id/thumbnails/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)