Skip to main content
A query to get the contents 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 Signing Requirements
  • The client operator private key is required to sign the query request
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
ConstructorDescription
new FileContentsQuery()Initializes a FileContentsQuery object
new FileContentsQuery()

​
Methods

MethodTypeDescription
setFileId(<fileId>)FileIdThe ID of the file to get contents for (x.z.y)
//Create the query
FileContentsQuery query = new FileContentsQuery()
    .setFileId(newFileId);

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

//Change to Utf-8 encoding
String contentsToUtf8 = contents.toStringUtf8();

System.out.println(contentsToUtf8);

//v2.0.0

//Create the query
const query = new FileContentsQuery()
    .setFileId(newFileId);

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

console.log(contents.toString());

//v2.0.7

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

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

fmt.Println(string(contents))

//v2.0.0

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

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

// Print the contents to the console
println!("File contents: {:?}", String::from_utf8_lossy(&contents));

// v0.34.0

​
Get query values

MethodTypeDescription
getFileId()FileIdThe ID of the file to get contents for (x.z.y)
//Create the query
FileContentsQuery query = new FileContentsQuery()
    .setFileId(newFileId);

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

//v2.0.0

//Create the query
const query = new FileContentsQuery()
    .setFileId(newFileId);

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

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

//v2.0.0

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

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

// v0.34.0