MadelineProtoDocs/old_docs/API_docs_v37/methods/upload.getFile.md

title	description	image	redirect_from
upload.getFile	Returns content of a whole file or its part.	https://docs.madelineproto.xyz/favicons/android-chrome-256x256.png	/API_docs/methods/upload_getFile.html

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
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');
$MadelineProto->start();

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

Or, if you're into Lua:

upload.File = upload.getFile({precise=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
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