topics

List topic messages by id

Changed on Aug 8, 2025

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

get/api/v1/topics/{topicId}/messages

Request

Base URL
(relative, and the document was published on a file host, not at the API’s origin)
URL
/api/v1/topics/{topicId}/messages
Auth
none declared

Path parameters

topicIdstring nullable required

Network entity ID in the format of shard.realm.num

Example:0.0.2

Topic id

Query parameters

encodingstring

limitinteger

The maximum number of items to return

order'asc' | 'desc'

The order in which items are listed

sequencenumberinteger

timestampstring[]

The consensus timestamp as a Unix timestamp in seconds.nanoseconds format with an optional comparison operator. See unixtimestamp.com for a simple way to convert a date to the 'seconds' part of the Unix time.

Response

Example response

{
  "messages": [
    {
      "chunk_info": {
        "initial_transaction_id": "0.0.10-1234567890-000000321",
        "nonce": 3,
        "number": 1,
        "total": 2,
        "scheduled": true
      },
      "consensus_timestamp": "1234567890.000000001",
      "message": "bWVzc2FnZQ==",
      "payer_account_id": "0.0.10",
      "running_hash": "cnVubmluZ19oYXNo",
      "running_hash_version": 2,
      "sequence_number": 1,
      "topic_id": "0.0.7"
    }
  ]
}

Changes

Aug 8, 2025v1db389f03b097 Revision changes
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status

Operation history