Skip to main content

/api/v1/topics/{topicId}/messages REST API Endpoint

Returns the list of topic messages for the given topic id.

Updated on
Aug 23, 2024

/api/v1/topics/{topicId}/messages REST API Endpoint

Please note that this method is currently available only on the testnet and will be accessible on the mainnet soon.

Path Parameters

topicId
string
REQUIRED
The network entity ID in the format of shard.realm.num

Query Parameters

encoding
string
The encoding format
limit
integer
The maximum number of items to return
order
string
The order in which items are listed (asc or desc)
sequencenumber
integer
The sequence number
timestamp
array
The consensus timestamp as a Unix timestamp in seconds.nanoseconds format with an optional comparison operator

Returns

messages
array
An array of objects, each representing a message published on the Hedera network
chunk_info
object
The chunk_info object which contains the following fields:
initial_transaction_id
string
The transaction ID of the initial transaction that started the chunked message
nonce
integer
The nonce value associated with the chunk
number
integer
The current chunk numbe
total
integer
The total number of chunks
scheduled
boolean
A boolean indicating whether the message is scheduled
consensus_timestamp
string
The consensus timestamp when the message was published
message
string
The message content, encoded in Base64
payer_account_id
string
The account ID of the payer for the message transaction
running_hash
string
The running hash of the message
running_hash_version
integer
The version of the running hash algorithm
sequence_number
integer
The sequence number of the message within the topic
topic_id
string
The ID of the topic to which the message was published
links
object
An object containing pagination links
next
string
The URL for the next set of results if available
Request
1
curl 'https://docs-demo.hedera-mainnet.quiknode.pro/api/v1/topics/{topicId}/messages'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free