topics

List topic messages by id

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

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

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

Changed in 1 of the 53 revisions of this API.11

Aug 8, 2025v1db389f03b09711See the full diff
- ▲
  the response property _status/messages/items/data became nullable for the status 400
  response-property-became-nullable
- ▲
  the response property _status/messages/items/data became nullable for the status 404
  response-property-became-nullable
- ▲
  the response property _status/messages/items/detail became nullable for the status 400
  response-property-became-nullable
- ▲
  the response property _status/messages/items/detail became nullable for the status 404
  response-property-became-nullable
- ▲
  the response property links/next became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property messages/items/chunk_info became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property messages/items/chunk_info/initial_transaction_id/account_id became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property messages/items/chunk_info/initial_transaction_id/nonce became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property messages/items/chunk_info/initial_transaction_id/scheduled became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property messages/items/payer_account_id became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property messages/items/topic_id became nullable for the status 200
  response-property-became-nullable
This revision also has 22 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history