Skip to main content
GET
/
v2
/
accounts
/
{account_id}
/
events
/
{event_id}
cURL
curl --request GET \
  --url https://tonapi.io/v2/accounts/{account_id}/events/{event_id}
{
  "event_id": "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e",
  "account": {
    "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
    "is_scam": true,
    "is_wallet": true,
    "name": "Ton foundation",
    "icon": "https://ton.org/logo.png"
  },
  "timestamp": 1234567890,
  "actions": [
    {
      "type": "TonTransfer",
      "status": "ok",
      "simple_preview": {
        "name": "Ton Transfer",
        "description": "Transferring 5 Ton",
        "accounts": [
          {
            "address": "0:10C1073837B93FDAAD594284CE8B8EFF7B9CF25427440EB2FC682762E1471365",
            "is_scam": true,
            "is_wallet": true,
            "name": "Ton foundation",
            "icon": "https://ton.org/logo.png"
          }
        ],
        "action_image": "<string>",
        "value": "5 Ton",
        "value_image": "<string>"
      },
      "base_transactions": [
        "e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e"
      ]
    }
  ],
  "is_scam": false,
  "lt": 25713146000001,
  "in_progress": false,
  "extra": 3,
  "progress": 0.5,
  "ext_msg_hash": "a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456"
}

Headers

​
Accept-Language
string
default:en
Example:

"ru-RU,ru;q=0.5"

Path Parameters

​
account_id
string<address>
required

account ID

Example:

"0:97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621"

​
event_id
string
required

event ID or transaction hash in hex (without 0x) or base64url format

Example:

"97264395BD65A255A429B11326C84128B7D70FFED7949ABAE3036D506BA38621"

Query Parameters

​
subject_only
boolean
default:false

filter actions where requested account is not real subject (for example sender or receiver jettons)

Response

account's event

High-level view over a transaction trace caused by a single inbound message. TonAPI analyses the trace, detects known patterns and groups low-level transactions into user-facing actions (Jetton transfer, NFT purchase, etc.). Actions are a best-effort UI abstraction and may change; do not rely on them for protocol-critical logic.

​
event_id
string
required
Example:

"e8b0e3fee4a26bd2317ac1f9952fcdc87dc08fdb617656b5202416323337372e"

​
account
object
required
​
timestamp
integer<int64>
required
Example:

1234567890

​
actions
object[]
required
​
is_scam
boolean
required

scam

Example:

false

​
lt
integer<int64>
required
Example:

25713146000001

​
in_progress
boolean
required

Event trace is not finished yet. Transactions still happening.

Example:

false

​
extra
integer<int64>
required

Net TON change for this account not explained by actions, in nanotons: extra = final_balance - initial_balance - sum(explicit TON changes from actions). extra < 0 - implicit fee, extra > 0 - refund. For UI display only

Example:

3

​
progress
number<float>
required

Event completion ratio in [0,1]

Required range: 0 <= x <= 1
Example:

0.5

​
ext_msg_hash
string

Normalized hash of the root external inbound message (hex).

Example:

"a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456"