Skip to main content
GET
/
api
/
v3
/
messages
Get messages
curl --request GET \
  --url https://toncenter.com/api/v3/messages
{
  "address_book": {},
  "messages": [
    {
      "bounce": true,
      "bounced": true,
      "created_at": "0",
      "created_lt": "0",
      "decoded_opcode": "<string>",
      "destination": "<string>",
      "extra_flags": "<string>",
      "fwd_fee": "0",
      "hash": "<string>",
      "hash_norm": "<string>",
      "ihr_disabled": true,
      "ihr_fee": "0",
      "import_fee": "0",
      "in_msg_tx_hash": "<string>",
      "init_state": {
        "body": "<string>",
        "decoded": {},
        "hash": "<string>"
      },
      "message_content": {
        "body": "<string>",
        "decoded": {},
        "hash": "<string>"
      },
      "opcode": 123,
      "out_msg_tx_hash": "<string>",
      "source": "<string>",
      "value": "0",
      "value_extra_currencies": {}
    }
  ],
  "metadata": {}
}

​
SDK Usage

import asyncio

from toncenter.rest import ToncenterRestClient
from toncenter.types import Network

MSG_HASH = ["4eee803beab5a31685b5c06a0716bd770f662db0395acbebc2ee6dd9c8227c34"]


async def main() -> None:
    async with ToncenterRestClient(network=Network.MAINNET) as client:
        result = await client.v3.blockchain.get_messages(
            msg_hash=MSG_HASH,
        )
        print(result.model_dump_json(indent=4))


if __name__ == "__main__":
    asyncio.run(main())

Query Parameters

​
msg_hash
string[]

Message hash. Acceptable in hex, base64 and base64url forms.

​
body_hash
string

Hash of message body.

​
source
string

The source account address. Can be sent in hex, base64 or base64url form. Use value null to get external messages.

​
destination
string

The destination account address. Can be sent in hex, base64 or base64url form. Use value null to get log messages.

​
opcode
string

Opcode of message in hex or signed 32-bit decimal form.

​
start_utime
integer

Query messages with created_at >= start_utime.

​
end_utime
integer

Query messages with created_at >= start_utime.

​
start_lt
integer

Query messages with created_lt >= start_lt.

​
end_lt
integer

Query messages with created_lt <= end_lt.

​
direction
enum<string>

Direction of message.

Available options:
in,
out
​
exclude_externals
boolean

Exclude external messages.

​
only_externals
boolean

Return only external messages.

​
limit
integer
default:10

Limit number of queried rows. Use with offset to batch read.

​
offset
integer
default:0

Skip first N rows. Use with limit to batch read.

​
sort
enum<string>
default:desc

Sort transactions by lt. If set to desc, you better set start_lt = 1 to get latest messages.

Available options:
asc,
desc

Response

OK

​
address_book
object
​
messages
object[]
​
metadata
object