Get file info

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 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.keys);

//v1.3.2
JavaScript
//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.keys);

//v1.4.4

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
JavaScript
//Create the query
FileInfoQuery query = new FileInfoQuery()
  .setFileId(fileId);

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

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

//v2.0.0

Last updated

#2871: HIP-423 long term scheduled transactions

Change request updated