topics

Get topic message by consensusTimestamp

Returns a topic message the given the consensusTimestamp.

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

Path parameters

timestampstring required

The Unix timestamp in seconds.nanoseconds format, the timestamp at which the associated transaction reached consensus. See unixtimestamp.com for a simple way to convert a date to the 'seconds' part of the Unix time.

Response

consensus_timestampstring required

A Unix timestamp in seconds.nanoseconds format

messagestring required

payer_account_idstring nullable required

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

running_hashstring byte required

running_hash_versioninteger required

sequence_numberinteger required

topic_idstring nullable required

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

Example response

{
  "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 2 of the 53 revisions of this API.102

Oct 16, 2025v153ec95c5c91d1See the full diff
- ●
  changed the pattern of the path request parameter timestamp from ^\d{1,10}(.\d{1,9})?$ to ^\d{1,10}(\.\d{1,9})?$
  request-parameter-pattern-changed
Aug 8, 2025v1db389f03b097101See 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 chunk_info became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property chunk_info/initial_transaction_id/account_id became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property chunk_info/initial_transaction_id/nonce became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property chunk_info/initial_transaction_id/scheduled became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property payer_account_id became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property topic_id became nullable for the status 200
  response-property-became-nullable
- ●
  changed the pattern of the path request parameter timestamp from ^\d{1,10}(\.\d{1,9})?$ to ^\d{1,10}(.\d{1,9})?$
  request-parameter-pattern-changed
This revision also has 22 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history