Sample - Slack Web API
GET/files.list

List files

Lists files for a team, channel, or user with optional filters. Use user, channel, ts_from, ts_to, and types to narrow the results, and use the paging parameters to control the returned page. The response includes matching files and paging metadata.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

9 parameters
tokenstringoptional
Authentication token with the `files:read` scope.
userstringoptional
Filter files created by a single user.
channelstringoptional
Filter files appearing in a specific channel by channel ID.
ts_fromnumberoptional
Filter files created at or after this timestamp.
ts_tonumberoptional
Filter files created at or before this timestamp.
typesstringoptional
Filter files by type; the default value is `all`, which does not filter the list.
countstringoptional
The requested number of files to return.
pagestringoptional
The page of results to retrieve.
show_files_hidden_by_limitbooleanoptional
Include truncated information for files hidden because of age or file-limit restrictions.

2 status codes
200Returns an object containing an array of file objects, a success indicator, and paging metadata.
filesarray<FileObject>required
okbooleanrequired
Allowed:true
pagingobjectrequired
defaultReturns an object with `ok` set to false and an `error` value when the file list cannot be retrieved or a filter is invalid.
callstackstringoptional
Note: PHP callstack is only visible in dev/qa
errorstringrequired
Allowed:user_not_foundunknown_typenot_authedinvalid_authaccount_inactiveno_permissionuser_is_botinvalid_arg_nameinvalid_array_arginvalid_charsetinvalid_form_datainvalid_post_type
okbooleanrequired
Allowed:false

Error handling

types defaults to all when omitted; otherwise, provide the file types you want to include. Use numeric ts_from and ts_to values for inclusive timestamp filtering, and provide a token with the files:read scope.