> ## Documentation Index > Fetch the complete documentation index at: https://developer.rocket.chat/llms.txt > Use this file to discover all available pages before exploring further. # Get Channel Files > Retrieves all the media files from a channel. ### Changelog | Version | Description | | ------- | ------------------------- | |9.0.0 | Removed the `fields` and `query` parameters. | | 0.64.0 | Change userId to user object in response | | 0.59.0 | Added | ## OpenAPI ````json GET /api/v1/channels.files { "openapi": "3.0.0", "info": { "version": "1.0.0", "title": "Rooms" }, "servers": [ { "url": "https://apiexplorer.support.rocket.chat" } ], "tags": [ { "name": "Channels" }, { "name": "Directory" }, { "name": "Groups" }, { "name": "Rooms" }, { "name": "Teams" }, { "name": "Room Invites" }, { "name": "Subscriptions" }, { "name": "ABAC" } ], "paths": { "/api/v1/channels.files": { "get": { "tags": [ "Channels" ], "summary": "Get Channel Files", "description": "Retrieves all the media files from a channel.\n\n### Changelog\n| Version | Description |\n| ------- | ------------------------- |\n|9.0.0 | Removed the `fields` and `query` parameters. |\n| 0.64.0 | Change userId to user object in response |\n| 0.59.0 | Added |", "operationId": "get-api-v1-channels.files", "parameters": [ { "$ref": "#/components/parameters/UserId" }, { "$ref": "#/components/parameters/Auth-Token" }, { "$ref": "#/components/parameters/Optional-RoomId" }, { "$ref": "#/components/parameters/Optional-RoomName" }, { "$ref": "#/components/parameters/sort" }, { "$ref": "#/components/parameters/count" }, { "$ref": "#/components/parameters/offset" }, { "$ref": "#/components/parameters/filterTypeGroup" }, { "$ref": "#/components/parameters/filterName" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "files": { "type": "array", "items": { "type": "object", "properties": { "_id": { "type": "string" }, "name": { "type": "string" }, "size": { "type": "integer" }, "type": { "type": "string" }, "rid": { "type": "string" }, "userId": { "type": "string" }, "store": { "type": "string" }, "_updatedAt": { "type": "string" }, "identify": { "type": "object", "properties": { "format": { "type": "string" }, "size": { "type": "object", "properties": { "width": { "type": "integer" }, "height": { "type": "integer" } } } } }, "complete": { "type": "boolean" }, "etag": { "type": "string" }, "path": { "type": "string" }, "progress": { "type": "integer" }, "token": { "type": "string" }, "uploadedAt": { "type": "string" }, "uploading": { "type": "boolean" }, "url": { "type": "string" }, "typeGroup": { "type": "string" }, "user": { "type": "object", "properties": { "_id": { "type": "string" }, "username": { "type": "string" }, "name": { "type": "string" } } } } } }, "count": { "type": "integer" }, "offset": { "type": "integer" }, "total": { "type": "integer" }, "success": { "type": "boolean" } } }, "examples": { "Example": { "value": { "files": [ { "_id": "651227bea2f73c7460e18c63", "name": "Screenshot (317).png", "size": 288727, "type": "image/png", "rid": "siyr2oWQJBjQjhLwr", "userId": "rbAXPnMktTFbNpwtJ", "store": "GridFS:Uploads", "_updatedAt": "2023-09-26T00:37:19.598Z", "identify": { "format": "png", "size": { "width": 1920, "height": 1080 } }, "complete": true, "etag": "2Q2D8hSxCdhQLzcpx", "path": "/file-upload/651227bea2f73c7460e18c63/Screenshot%20(317).png", "progress": 1, "token": "da2aCAf88a", "uploadedAt": "2023-09-26T00:37:18.168Z", "uploading": false, "url": "http://localhost:3000/file-upload/651227bea2f73c7460e18c63/Screenshot%20(317).png", "typeGroup": "image", "user": { "_id": "rbAXPnMktTFbNpwtJ", "username": "roxie", "name": "test test" } }, { "_id": "64b589e6aa5ad4273bfc4db6", "name": "eicar.zip", "size": 266, "type": "application/x-zip-compressed", "rid": "siyr2oWQJBjQjhLwr", "userId": "rbAXPnMktTFbNpwtJ", "store": "GridFS:Uploads", "_updatedAt": "2023-07-17T18:35:18.242Z", "complete": true, "etag": "JYaAzzFQSnxYQ7rWW", "path": "/file-upload/64b589e6aa5ad4273bfc4db6/eicar.zip", "progress": 1, "token": "7a1A38Cb5a", "uploadedAt": "2023-07-17T18:35:18.216Z", "uploading": false, "url": "http://localhost:3000/file-upload/64b589e6aa5ad4273bfc4db6/eicar.zip", "typeGroup": "application", "user": { "_id": "rbAXPnMktTFbNpwtJ", "username": "roxie", "name": "test test" } } ], "count": 2, "offset": 0, "total": 2, "success": true } } } } } } } } } }, "components": { "parameters": { "UserId": { "name": "X-User-Id", "in": "header", "description": "The `userId` of the authenticated user.", "required": true, "schema": { "type": "string" }, "example": "rbAXPnMktTFbNpwtJ" }, "Auth-Token": { "name": "X-Auth-Token", "in": "header", "description": "The `authToken` of the authenticated user.", "required": true, "schema": { "type": "string" }, "example": "RScctEHSmLGZGywfIhWyRpyofhKOiMoUIpimhvheU3f" }, "Optional-RoomId": { "name": "roomId", "in": "query", "description": "The room ID. It is required if the `roomName` is not provided.", "schema": { "type": "string" }, "example": "dlpfuijw7ej" }, "Optional-RoomName": { "name": "roomName", "in": "query", "description": "The room name. It is required if the `roomId` is not provided.", "required": false, "schema": { "type": "string" }, "example": "general" }, "sort": { "name": "sort", "in": "query", "description": "List of fields to order by, and in which direction. This is a JSON object, with properties listed in desired order, with values of 1 for ascending, or -1 for descending. For example, {\"value\": -1, \"_id\": 1}. Refer to the [official documentation](https://developer.rocket.chat/apidocs/query-parameters#pagination) to learn more.", "required": false, "schema": {} }, "count": { "name": "count", "in": "query", "description": "The number of items to return. Refer to the [official documentation](https://developer.rocket.chat/apidocs/query-parameters#pagination) to learn more.", "required": false, "schema": { "type": "integer" }, "example": 50 }, "offset": { "name": "offset", "in": "query", "description": "Number of items to \"skip\" in the query, i.e. requests return count items, skipping the first offset items. Refer to the [official documentation](https://developer.rocket.chat/apidocs/query-parameters#pagination) to learn more.", "required": false, "schema": { "type": "integer" }, "example": 50 }, "filterTypeGroup": { "name": "typeGroup", "in": "query", "description": "Filter results by the type of file. Available options:\n- `all`: Return all file types.\n- `image`: Filter by image files.\n- `video`: Filter by video files.\n- `audio`: Filter by audio files.\n- `text`: Filter by text documents.\n- `application`: Filter by other file types.", "schema": { "type": "string" }, "example": "images" }, "filterName": { "name": "name", "in": "query", "description": "The name of the file to search for.", "schema": { "type": "string" }, "example": "logo" } } } } ````