Own Slack? Customize your docs with AI search, analytics, and more.

GET

/files.list

https://slack.com/files.list

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

Access Token Required: API Key

Query Params

tokenstring

Authentication token. Requires scope: `files:read`

userstring

Filter files created by a single user.

channelstring

Filter files appearing in a specific channel, indicated by its ID.

ts_fromstring

Filter files created after this timestamp (inclusive).

ts_tostring

Filter files created before this timestamp (inclusive).

typesstring

Filter files by type ([see below](#file_types)). You can pass multiple values in the types argument, like `types=spaces,snippets`.The default value is `all`, which does not filter the list.

countstring

pagestring

show_files_hidden_by_limitstring

Show truncated file info for files hidden due to being too old, and the team who owns the file being over the file limit.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'https://slack.com/files.list' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}

GET