---
title: "Get preview info for a file by document version"
method: GET
path: "/matters/{matterId}/documents/files/{fileId}/preview/{documentVersionId}"
tags: ["Files"]
---

# Get preview info for a file by document version

`GET /matters/{matterId}/documents/files/{fileId}/preview/{documentVersionId}`

Returns a presigned URL to the PDF preview of a specific document version of the file.
The URL is valid for 1 day from the time of the request.

## Path parameters

- `matterId` string, required
- `fileId` string, required
- `documentVersionId` string, required

## Response `200`

When the request is successful. Returns a 'PreviewFileInfo' object.

- PreviewFileInfo
  - `fileId` string, nullable — Unique identifier of the requested file
  - `documentVersionId` string, nullable — Unique identifier of the document version the preview was generated from. Pass this to GetPreviewById.
  - `downloadUrl` string, nullable — Temporary presigned URL to download the PDF preview. Valid for 1 day. Null when the preview has not been generated yet (conversion is pending); poll GetPreviewById until it is available.
  - `expiry` string, date-time, nullable — Expiry date/time (UTC) after which the download link is no longer accessible. Null when the preview has not been generated yet (conversion is pending).

## Other responses

- `400` — When a supplied matterId or fileId is not a valid GUID.
- `403` — When the file does not belong to the authenticated account or does not exist.
- `404` — When the file has no uploaded version yet, or no preview exists for the specified document version (for example the conversion requested by CreatePreview is still pending).

## Changes

- **2026-08-26** `db1b8a86b58e` — 1 info
  - added the optional property `errors` to the response with the `400` status

[Change history](https://skmtc.dev/smokeball/apis/api/changes/matters/:matterId/documents/files/:fileId/preview/:documentVersionId/get.md)

---

[API](https://skmtc.dev/smokeball/apis/api.md) · [All operations](https://skmtc.dev/smokeball/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smokeball/api/revisions/db1b8a86b58e/schema)