---
title: "Get document thumbnail"
method: GET
path: "/api/v3/files/{id}/thumbnail"
tags: ["Files"]
---

# Get document thumbnail

`GET /api/v3/files/{id}/thumbnail`

## Request

- Base URL: `https://api.lighton.ai`
- URL: `https://api.lighton.ai/api/v3/files/{id}/thumbnail`
- Auth: HTTP bearer

Returns the 256x256 WebP thumbnail for a document. Thumbnails are generated asynchronously after ingestion completes: poll the `thumbnail.status` field on the file resource and request this endpoint once it reads `READY`.

## Path parameters

- `id` integer, required

## Response `200`

WebP thumbnail image stream (`image/webp`)

## Other responses

- `401`: Authentication credentials were not provided or are invalid
- `404`: The requested resource was not found
- `503`: API is under maintenance. Check `GET /api/v3/system/status` for active periods and retry.

## Changes

- **2026-11-03** `63ecbc61b6a9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lighton/apis/lighton-api/changes/api/v3/files/:id/thumbnail/get.md)

---

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