---
title: "GET /files.list"
method: GET
path: "/files.list"
tags: ["files"]
---

# GET /files.list

`GET /files.list`

List for a team, in a channel, or from a user with applied filters.

## Query parameters

- `token` string
- `user` string
- `channel` string
- `ts_from` number
- `ts_to` number
- `types` string
- `count` string
- `page` string
- `show_files_hidden_by_limit` boolean

## Response `200`

Typical success response

- object — Schema for successful response from files.list method
  - `files` ObjsFile[], required
    - `channels` DefsChannelId[]
    - `comments_count` integer
    - `created` integer
    - `date_delete` integer
    - `display_as_bot` boolean
    - `editable` boolean
    - `editor` string
    - `external_id` string
    - `external_type` string
    - `external_url` string, uri
    - `filetype` string
    - `groups` DefsGroupId[]
    - `has_rich_preview` boolean
    - `id` string
    - `image_exif_rotation` integer
    - `ims` DefsDmId[]
    - `is_external` boolean
    - `is_public` boolean
    - `is_starred` boolean
    - `is_tombstoned` boolean
    - `last_editor` string
    - `mimetype` string
    - `mode` string
    - `name` string
    - `non_owner_editable` boolean
    - `num_stars` integer
    - `original_h` integer
    - `original_w` integer
    - `permalink` string, uri
    - `permalink_public` string, uri
    - `pinned_info` DefsPinnedInfo
    - `pinned_to` DefsChannel[]
    - `pretty_type` string
    - `preview` string
    - `public_url_shared` boolean
    - `reactions` ObjsReaction[]
      - `count` integer, required
      - `name` string, required
      - `users` DefsUserId[], required
    - `shares` object
      - `private` unknown
      - `public` unknown
    - `size` integer
    - `source_team` string
    - `state` string
    - `thumb_1024` string, uri
    - `thumb_1024_h` integer
    - `thumb_1024_w` integer
    - `thumb_160` string, uri
    - `thumb_360` string, uri
    - `thumb_360_h` integer
    - `thumb_360_w` integer
    - `thumb_480` string, uri
    - `thumb_480_h` integer
    - `thumb_480_w` integer
    - `thumb_64` string, uri
    - `thumb_720` string, uri
    - `thumb_720_h` integer
    - `thumb_720_w` integer
    - `thumb_80` string, uri
    - `thumb_800` string, uri
    - `thumb_800_h` integer
    - `thumb_800_w` integer
    - `thumb_960` string, uri
    - `thumb_960_h` integer
    - `thumb_960_w` integer
    - `thumb_tiny` string
    - `timestamp` integer
    - `title` string
    - `updated` integer
    - `url_private` string, uri
    - `url_private_download` string, uri
    - `user` string
    - `user_team` string
    - `username` string
  - `ok` true, required
  - `paging` ObjsPaging, required
    - `count` integer
    - `page` integer, required
    - `pages` integer
    - `per_page` integer
    - `spill` integer
    - `total` integer, required

## Other responses

- `default` — Typical error response

---

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