Try locate result transaction

Finds the transaction that received a specific message. Given message parameters, returns the transaction on the destination account that processed the incoming message. Use this to trace message delivery across accounts.

POST /api/v2/tryLocateResultTx

Try it

Try locate result transaction

cURL

curl --request POST \
  --url https://toncenter.com/api/v2/tryLocateResultTx \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "source": "<string>",
  "destination": "<string>",
  "created_lt": "<string>"
}
'

200

{
  "ok": true,
  "result": {
    "@type": "ext.transaction",
    "address": {
      "@type": "accountAddress",
      "account_address": "<string>"
    },
    "account": "<string>",
    "utime": 123,
    "data": "<string>",
    "transaction_id": {
      "@type": "internal.transactionId",
      "lt": "<string>",
      "hash": "<string>"
    },
    "fee": "<string>",
    "storage_fee": "<string>",
    "other_fee": "<string>",
    "out_msgs": [
      {
        "@type": "ext.message",
        "hash": "<string>",
        "source": "<string>",
        "destination": "<string>",
        "value": "<string>",
        "extra_currencies": [
          {
            "@type": "extraCurrency",
            "id": 123,
            "amount": "<string>"
          }
        ],
        "fwd_fee": "<string>",
        "ihr_fee": "<string>",
        "created_lt": "<string>",
        "body_hash": "<string>",
        "msg_data": {
          "@type": "msg.dataRaw",
          "body": "<string>",
          "init_state": "<string>"
        },
        "message": "<string>",
        "message_decode_error": "<string>"
      }
    ],
    "in_msg": {
      "@type": "ext.message",
      "hash": "<string>",
      "source": "<string>",
      "destination": "<string>",
      "value": "<string>",
      "extra_currencies": [
        {
          "@type": "extraCurrency",
          "id": 123,
          "amount": "<string>"
        }
      ],
      "fwd_fee": "<string>",
      "ihr_fee": "<string>",
      "created_lt": "<string>",
      "body_hash": "<string>",
      "msg_data": {
        "@type": "msg.dataRaw",
        "body": "<string>",
        "init_state": "<string>"
      },
      "message": "<string>",
      "message_decode_error": "<string>"
    }
  },
  "@extra": "<string>"
}

Authorizations

X-API-Key · string · header · required

Body

application/json

source · string · required

Sender address. Empty string for external messages (sent from outside the blockchain).

destination · string · required

Recipient address.

created_lt · required

Logical time when this message was created. Use with source and destination to uniquely identify a message.

Response

200

application/json

OK

Response containing the result transaction.

ok · boolean · default: true · required

Indicates if the request succeeded. If false, check the error field for details.

result · object · required

The response data. Only present when ok is true.

Show child attributes

result. @type · enum<string> · default: ext.transaction · required

Object type identifier.

Available options: ext.transaction

result. address · object · required

The account address in user-friendly format.

Show child attributes

result.address. @type · enum<string> · default: accountAddress

Object type identifier.

Available options: accountAddress

result.address. account_address · string

The account address in user-friendly format.

result. account · string · required

The account address that this transaction belongs to.

result. utime · integer · required

Unix timestamp (seconds since 1970-01-01). When this event occurred in real-world time.

result. data · string · required

Raw transaction or contract data in BOC (Bag of Cells) format, base64 encoded.

result. transaction_id · object · required

Reference to this transaction. Use lt and hash to fetch full details.

Show child attributes

result.transaction_id. @type · enum<string> · default: internal.transactionId · required

Object type identifier.

Available options: internal.transactionId

result.transaction_id. lt · string · required

Logical time of this event. A globally unique counter that orders all blockchain events. Higher values are more recent.

result.transaction_id. hash · string · required

Unique identifier hash for this object.

result. fee · string · required

Total fees paid for this transaction in nanotons.

result. storage_fee · string · required

Fees paid for storing the contract state on-chain, in nanotons. Charged based on contract size and time.

result. other_fee · string · required

Computation and action fees in nanotons. Covers gas for executing contract code.

result. out_msgs · object[] · required

Messages sent by this transaction. A transaction can send multiple messages to different destinations.

Show child attributes

result.out_msgs. @type · enum<string> · default: ext.message · required

Object type identifier.

Available options: ext.message

result.out_msgs. hash · string · required

Unique identifier hash for this object.

result.out_msgs. source · string · required

Sender address. Empty string for external messages (sent from outside the blockchain).

result.out_msgs. destination · string · required

Recipient address.

result.out_msgs. value · string · required

Amount of TON transferred in this message, in nanotons (1 TON = 10^9 nanotons).

result.out_msgs. extra_currencies · object[] · required

Non-TON currencies transferred. TON supports multiple native currencies.

Show child attributes

result.out_msgs.extra_currencies. @type · enum<string> · default: extraCurrency · required

Object type identifier.

Available options: extraCurrency

result.out_msgs.extra_currencies. id · integer<int32> · required

Request ID. Pass any string and it will be echoed in the response.

result.out_msgs.extra_currencies. amount · string · required

Balance amount as string.

result.out_msgs. fwd_fee · string · required

Fee for forwarding this message to its destination, in nanotons.

result.out_msgs. ihr_fee · string · required

Instant Hypercube Routing fee in nanotons. Usually 0 as IHR is rarely used.

result.out_msgs. created_lt · string · required

Logical time when this message was created. Use with source and destination to uniquely identify a message.

result.out_msgs. body_hash · string · required

Hash of the message body. Use this to verify message content without the full body.

result.out_msgs. msg_data · object · required

The message body containing instructions for the destination contract.

Option 1

Show child attributes

result.out_msgs.msg_data. @type · enum<string> · default: msg.dataRaw

Object type identifier.

Available options: msg.dataRaw

result.out_msgs.msg_data. body · string

Message body in BOC format, base64 encoded.

result.out_msgs.msg_data. init_state · string

Contract init state in base64.

result.out_msgs. message · string

Human-readable comment if the message body is a simple text comment.

result.out_msgs. message_decode_error · string

Error text if the message body couldn't be decoded as a comment.

result. in_msg · object

The incoming message that triggered this transaction. External messages come from outside the blockchain.

Show child attributes

result.in_msg. @type · enum<string> · default: ext.message · required

Object type identifier.

Available options: ext.message

result.in_msg. hash · string · required

Unique identifier hash for this object.

result.in_msg. source · string · required

Sender address. Empty string for external messages (sent from outside the blockchain).

result.in_msg. destination · string · required

Recipient address.

result.in_msg. value · string · required

Amount of TON transferred in this message, in nanotons (1 TON = 10^9 nanotons).

result.in_msg. extra_currencies · object[] · required

Non-TON currencies transferred. TON supports multiple native currencies.

Show child attributes

result.in_msg.extra_currencies. @type · enum<string> · default: extraCurrency · required

Object type identifier.

Available options: extraCurrency

result.in_msg.extra_currencies. id · integer<int32> · required

Request ID. Pass any string and it will be echoed in the response.

result.in_msg.extra_currencies. amount · string · required

Balance amount as string.

result.in_msg. fwd_fee · string · required

Fee for forwarding this message to its destination, in nanotons.

result.in_msg. ihr_fee · string · required

Instant Hypercube Routing fee in nanotons. Usually 0 as IHR is rarely used.

result.in_msg. created_lt · string · required

Logical time when this message was created. Use with source and destination to uniquely identify a message.

result.in_msg. body_hash · string · required

Hash of the message body. Use this to verify message content without the full body.

result.in_msg. msg_data · object · required

The message body containing instructions for the destination contract.

Option 1

Show child attributes

result.in_msg.msg_data. @type · enum<string> · default: msg.dataRaw

Object type identifier.

Available options: msg.dataRaw

result.in_msg.msg_data. body · string

Message body in BOC format, base64 encoded.

result.in_msg.msg_data. init_state · string

Contract init state in base64.

result.in_msg. message · string

Human-readable comment if the message body is a simple text comment.

result.in_msg. message_decode_error · string

Error text if the message body couldn't be decoded as a comment.

@extra · string

Optional request ID that you can pass in the request and receive back in the response. Useful for matching async responses.