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

# Get files on a matter

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

Returns a list of files associated with a matter. 
Defaults to ascending order of date created, i.e. oldest first, unless sort option is supplied.
Custom sorting and searching options does not apply to cursor-based pagination.

## Path parameters

- `matterId` string, required

## Query parameters

- `Offset` integer
- `Limit` integer
- `Cursor` string
- `Sort` string
- `Search` string[]

## Response `200`

When request is successful. Returns a paged collection of 'File' objects.

- FilePagedCollection
  - `id` string, nullable
  - `href` string, nullable
  - `relation` string, nullable
  - `method` string, nullable
  - `self` Link
    - `id` string, nullable
    - `href` string, nullable
    - `relation` string, nullable
    - `method` string, nullable
  - `value` File[], nullable
    - `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.
  - `offset` integer, nullable
  - `limit` integer, nullable
  - `size` integer
  - `first` Link
    - `id` string, nullable
    - `href` string, nullable
    - `relation` string, nullable
    - `method` string, nullable
  - `previous` Link
    - `id` string, nullable
    - `href` string, nullable
    - `relation` string, nullable
    - `method` string, nullable
  - `next` Link
    - `id` string, nullable
    - `href` string, nullable
    - `relation` string, nullable
    - `method` string, nullable
  - `last` Link
    - `id` string, nullable
    - `href` string, nullable
    - `relation` string, nullable
    - `method` string, nullable

## Other responses

- `403` — When the requested matter does not belong to the account making the request.

---

[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/versions/197984da9b42/schema)