# Method: upload.getFile

Back to methods index

Returns content of a whole file or its part.

# Parameters:

Name Type Description Required
precise Bool Disable some checks on limit and offset values, useful for example to stream videos by keyframes Optional
cdn_supported Bool Whether the current client supports CDN downloads Optional
location InputFileLocation File location Yes
offset int Number of bytes to be skipped Yes
limit int Number of bytes to be returned Yes

# Return type: upload.File

# Can bots use this method: YES

# MadelineProto Example (now async for huge speed and parallelism!):

if (!file_exists('madeline.php')) {
    copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php');
include 'madeline.php';

$MadelineProto = new \danog\MadelineProto\API('session.madeline');

$upload_File = $MadelineProto->upload->getFile(['precise' => Bool, 'cdn_supported' => Bool, 'location' => InputFileLocation, 'offset' => int, 'limit' => int, ]);

Or, if you’re into Lua:

upload_File = upload.getFile({precise=Bool, cdn_supported=Bool, location=InputFileLocation, offset=int, limit=int, })

# Errors

Code Type Description
400 CHANNEL_INVALID The provided channel is invalid
400 CHANNEL_PRIVATE You haven’t joined this channel/supergroup
400 FILE_ID_INVALID The provided file id is invalid
400 FILE_REFERENCE_EXPIRED File reference expired, it must be refetched as described in https://core.telegram.org/api/file_reference
400 INPUT_FETCH_FAIL Failed deserializing TL payload
400 LIMIT_INVALID The provided limit is invalid
400 LOCATION_INVALID The provided location is invalid
400 MSG_ID_INVALID Invalid message ID provided
400 OFFSET_INVALID The provided offset is invalid
400 PEER_ID_INVALID The provided peer id is invalid
406 AUTH_KEY_DUPLICATED An auth key with the same ID was already generated
406 FILEREF_UPGRADE_NEEDED The client has to be updated in order to support file references
401 AUTH_KEY_PERM_EMPTY The temporary auth key must be binded to the permanent auth key to use these methods.
-503 Timeout Timeout while fetching data
This site uses cookies, as described in the cookie policy. By clicking on "Accept" you consent to the use of cookies.