topics

Get topic message by consensusTimestamp

Changed on Oct 16, 2025

Returns a topic message the given the consensusTimestamp.

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

Request

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

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

Oct 16, 2025v153ec95c5c91d Revision changes
- warning
  changed the pattern of the path request parameter timestamp from ^\d{1,10}(.\d{1,9})?$ to ^\d{1,10}(\.\d{1,9})?$
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
- warning
  changed the pattern of the path request parameter timestamp from ^\d{1,10}(\.\d{1,9})?$ to ^\d{1,10}(.\d{1,9})?$

Operation history