---
title: "Get a file"
method: GET
path: "/matters/{matterId}/documents/files/{fileId}"
tags: ["Files"]
---

# Get a file

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

Retrieves a specified file.

## Path parameters

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

## Response `200`

When request is successful. Returns a 'File' object.

- File
  - `href` string, nullable
  - `relation` string, nullable
  - `method` string, nullable
  - `self` Link
    - `id` string, nullable
    - `href` string, nullable
    - `relation` string, nullable
    - `method` string, nullable
  - `id` string, nullable — Unique identifier of the file.
  - `versionId` string, nullable — Unique identifier of the file's current version.
  - `folder` Link
    - `id` string, nullable
    - `href` string, nullable
    - `relation` string, nullable
    - `method` string, nullable
  - `matter` Link
    - `id` string, nullable
    - `href` string, nullable
    - `relation` string, nullable
    - `method` string, nullable
  - `name` string, nullable — Name of the file, excluding file extension.
  - `fileExtension` string, nullable — Extension of the file.
  - `ownerId` string, nullable — Unique identifier of the user who created/uploaded this file.
  - `to` string, nullable — The 'To' or recipients' email address (only applicable for email files).
  - `from` string, nullable — The 'From' or sender's email address (only applicable for email files).
  - `dateCreated` string, date-time — The original datetime that the file was created.
  - `dateModified` string, date-time — The datetime that the file was last modified.
  - `sizeBytes` integer — Size of the file (in bytes).
  - `downloadInfo` Link
    - `id` string, nullable
    - `href` string, nullable
    - `relation` string, nullable
    - `method` string, nullable
  - `additionalData` object, nullable — Collection of file meta data as KeyValuePair(string, object).
  - `isFavorite` boolean — Flag indicating whether this file is a favorite
  - `isUploaded` boolean — Flag indicating whether the file contents are uploaded to the server.
  - `isCancelled` boolean — Flag indicating whether the file upload has been cancelled.
  - `isDuplicate` boolean — Flag indicating whether the file data is duplicated. Applies to emails only for now.
  - `isDeleted` boolean — Flag indicating whether the file has been deleted.

## Other responses

- `403` — When the requested file does not belong to the account making the request.
- `404` — When file with the specified id does not exist.

---

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