messages - Ton

messages. Retrieves a list of messages

messages - ton [Value: 100CU]
Retrieves a list of messages
Use cases

Use cases

  • Retrieve data on TON messages
  • Analyze message details and history
  • Audit message transactions
Constraints

Constraints

  • Requires valid message ID
  • Supports Messages V3 only
  • Depends on sync
Get started
Unlock Access to 50+ chains
Boost your app's speed and reliability with dRPC - get your access API key

Language

Request
Examples
curl --request GET \
     --url ' https://ton.drpc.org/rest/api/v3/messages?limit=128&offset=0&sort=desc' \
     --header 'accept: application/json'
Copy
Response
200
{
    "ok": true,
    "result": [
        {
            "message_id": "0:abcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdef",
            "from": "EQD1Lp1KcmGHFpE8eIvL1mnHT83b4HdB8HJxuSfq6Rq4zGyN",
            "to": "EQDzSp9Qc6KcJXGJc7NkSVxj2pzLsmM4NdFpc8i2dZqjU9i9",
            "body": "Hello, this is a test message.",
            "timestamp": 1693527600,
            "status": "sent",
            "transaction_id": "0:a9d39a7f1e5f849835496b052885ed2ac07d54d5e0e11f2b17c3b00e3295a2b0"
        },
        {
            "message_id": "0:1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
            "from": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2",
            "to": "EQC7VpEHw2DA9hxkdx_WXv9NSkb_v_KVQMY2Le4a4Fk9DUqQ",
            "body": "Monthly subscription payment notification.",
            "timestamp": 1693527500,
            "status": "delivered",
            "transaction_id": "0:b2c43e5f2f4a849835496b052885ed2ac07d54d5e0e11f2b17c3b00e3295a2a1"
        }
    ]
}
Copy

Request params

Parametersobject
object
limitinteger
The maximum number of blocks to return. Default is 128.
offsetinteger
The number of blocks to skip before starting to return results. Default is 0.
sortstring
The sorting order of the blocks. Possible values are 'asc' for ascending or 'desc' for descending. Default is 'desc'.

Response

200

Response params

object
okboolean
Indicates if the request was successful.
resultarray
List of message details.
object
message_idstring
Unique identifier of the message.
fromstring
Address of the sender.
tostring
Address of the recipient.
bodystring
Content of the message.
timestampinteger
Unix timestamp when the message was sent.
statusstring
Current status of the message (e.g., sent, delivered).
transaction_idstring
Identifier of the transaction associated with the message.
jsonRPC