Get file info

Query Hedera File Service (HFS) file metadata with FileInfoQuery, returning size, expiration, keys, deletion status, and memo for a given file ID.

A query that returns the current state of a file. Queries do not change the state of the file or require network consensus. The information is returned from a single node processing the query.

Query Fees

• Please see the transaction and query fees table for the base transaction fee
• Please use the Hedera fee estimator to estimate your query fee cost

File Info Response

Field	Description
File ID	The Hedera ID of the file
Key(s)	The current admin key(s) on the account
Size	The number of bytes in the file contents
Expiration Time	The current time at which the file is set to expire
Deleted	Whether or not the file has been deleted
Ledger ID	The ID of the network the response came from. See HIP-198.
Memo	A short description, if any

Query Signing Requirements

• The client operator account paying for the query fees is required to sign

Constructor	Description
new FileInfoQuery()	Initializes the FileInfoQuery object

new FileInfoQuery()

Methods

Method	Type	Description
setFileId(<fileId>)	FileId	The ID of the file to get information for (x.y.z)

Java

//Create the query
FileInfoQuery query = new FileInfoQuery()
  .setFileId(fileId);

//Sign the query with the client operator private key and submit to a Hedera network
FileInfo getInfo = query.execute(client);

System.out.println("File info response: " +getInfo);

//Create the query
const query = new FileInfoQuery()
  .setFileId(fileId);

//Sign the query with the client operator private key and submit to a Hedera network
const getInfo = await query.execute(client);

console.log("File info response: " + getInfo);

//Create the query
query := hedera.NewFileInfoQuery().
    SetFileID(newFileId)

//Sign the query with the client operator private key and submit to a Hedera network
getInfo, err := query.Execute(client)

fmt.Println(getInfo)

// Create the query
let query = FileInfoQuery::new()
    .file_id(file_id);

// Submit the query to a Hedera network
let file_info = query.execute(&client).await?;

// Print the file info to the console
println!("File info: {:?}", file_info);

// v0.34.0

Sample Output:

FileInfo{
     fileId=0.0.104926, 
     size=26, 
     expirationTime=2021-02-10T17:48:15Z, 
     deleted=false, 
     keys=[ 302a300506032b6570032100100059296cc51f5d362a3859d3c3c74c6a480cffad9d669a10c1d447ce56e5bf
     ]
}

Get query values

Method	Type	Description
getFileId()	FileId	The ID of the file to get contents for (x.z.y)

Java

//Create the query
FileInfoQuery query = new FileInfoQuery()
  .setFileId(fileId);

//Get file ID
FileId getFileId = query.getFileId();

//v2.0.0

//Create the query
const query = new FileInfoQuery()
  .setFileId(fileId);

//Get file ID
const getFileId = query.getFileId();

//v2.0.0

//Create the query
query := hedera.NewFileContentsQuery().
		SetFileID(newFileId)
		
//Get file ID
getFileId := query.GetFileID()

//v2.0.0

// Create the query
let query = FileInfoQuery::new()
    .file_id(file_id);

// Get the file ID
let file_id = query.get_file_id();

// v0.34.0