files list

GET {{baseUrl}}/files.list?user=<string>&channel=<string>&ts_from=<number>&ts_to=<number>&types=<string>&count=<string>&page=<string>&show_files_hidden_by_limit=<boolean>

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

Request Params

KeyDatatypeRequiredDescription
userstringFilter files created by a single user.
channelstringFilter files appearing in a specific channel, indicated by its ID.
ts_fromstringFilter files created after this timestamp (inclusive).
ts_tostringFilter files created before this timestamp (inclusive).
typesstringFilter files by type (see below). 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_limitstringShow truncated file info for files hidden due to being too old, and the team who owns the file being over the file limit.

RESPONSES

status: OK

{&quot;ok&quot;:&quot;\u003cboolean\u003e&quot;,&quot;files&quot;:[{&quot;channels&quot;:[&quot;\u003cstring\u003e&quot;],&quot;comments_count&quot;:&quot;\u003cinteger\u003e&quot;,&quot;created&quot;:&quot;\u003cinteger\u003e&quot;,&quot;date_delete&quot;:&quot;\u003cinteger\u003e&quot;,&quot;display_as_bot&quot;:&quot;\u003cboolean\u003e&quot;,&quot;editable&quot;:&quot;\u003cboolean\u003e&quot;,&quot;editor&quot;:&quot;\u003cstring\u003e&quot;,&quot;external_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;external_type&quot;:&quot;\u003cstring\u003e&quot;,&quot;external_url&quot;:&quot;\u003curi\u003e&quot;,&quot;filetype&quot;:&quot;\u003cstring\u003e&quot;,&quot;groups&quot;:[&quot;\u003cstring\u003e&quot;],&quot;has_rich_preview&quot;:&quot;\u003cboolean\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;image_exif_rotation&quot;:&quot;\u003cinteger\u003e&quot;,&quot;ims&quot;:[&quot;\u003cstring\u003e&quot;],&quot;is_external&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_public&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_starred&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_tombstoned&quot;:&quot;\u003cboolean\u003e&quot;,&quot;last_editor&quot;:&quot;\u003cstring\u003e&quot;,&quot;mimetype&quot;:&quot;\u003cstring\u003e&quot;,&quot;mode&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;non_owner_editable&quot;:&quot;\u003cboolean\u003e&quot;,&quot;num_stars&quot;:&quot;\u003cinteger\u003e&quot;,&quot;original_h&quot;:&quot;\u003cinteger\u003e&quot;,&quot;original_w&quot;:&quot;\u003cinteger\u003e&quot;,&quot;permalink&quot;:&quot;\u003curi\u003e&quot;,&quot;permalink_public&quot;:&quot;\u003curi\u003e&quot;,&quot;pinned_info&quot;:&quot;\u003cobject\u003e&quot;,&quot;pinned_to&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;pretty_type&quot;:&quot;\u003cstring\u003e&quot;,&quot;preview&quot;:&quot;\u003cstring\u003e&quot;,&quot;public_url_shared&quot;:&quot;\u003cboolean\u003e&quot;,&quot;reactions&quot;:[{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;users&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;count&quot;:&quot;\u003cinteger\u003e&quot;},{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;users&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;count&quot;:&quot;\u003cinteger\u003e&quot;}],&quot;shares&quot;:{&quot;private&quot;:{},&quot;public&quot;:{}},&quot;size&quot;:&quot;\u003cinteger\u003e&quot;,&quot;source_team&quot;:&quot;\u003cstring\u003e&quot;,&quot;state&quot;:&quot;\u003cstring\u003e&quot;,&quot;thumb_1024&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_1024_h&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_1024_w&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_160&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_360&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_360_h&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_360_w&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_480&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_480_h&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_480_w&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_64&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_720&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_720_h&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_720_w&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_80&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_800&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_800_h&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_800_w&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_960&quot;:&quot;\u003curi\u003e&quot;,&quot;thumb_960_h&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_960_w&quot;:&quot;\u003cinteger\u003e&quot;,&quot;thumb_tiny&quot;:&quot;\u003cstring\u003e&quot;,&quot;timestamp&quot;:&quot;\u003cinteger\u003e&quot;,&quot;title&quot;:&quot;\u003cstring\u003e&quot;,&quot;updated&quot;:&quot;\u003cinteger\u003e&quot;,&quot;url_private&quot;:&quot;\u003curi\u003e&quot;,&quot;url_private_download&quot;:&quot;\u003curi\u003e&quot;,&quot;user&quot;:&quot;\u003cstring\u003e&quot;,&quot;user_team&quot;:&quot;\u003cstring\u003e&quot;,&quot;username&quot;:&quot;\u003cstring\u003e&quot;}],&quot;paging&quot;:{&quot;page&quot;:&quot;\u003cinteger\u003e&quot;,&quot;total&quot;:&quot;\u003cinteger\u003e&quot;,&quot;count&quot;:&quot;\u003cinteger\u003e&quot;,&quot;pages&quot;:&quot;\u003cinteger\u003e&quot;,&quot;per_page&quot;:&quot;\u003cinteger\u003e&quot;,&quot;spill&quot;:&quot;\u003cinteger\u003e&quot;}}