transactions

Try Locate Transaction

Finds a transaction by message parameters. Given a source address, destination address, and message creation time (created_lt), returns the transaction that processed this message. Useful for locating when a previously sent message was executed.

get/api/v2/tryLocateTx

Request

  • Base URL: https://toncenter.com (the document declares no server; this is the origin it was published from)
  • URL: https://toncenter.com/api/v2/tryLocateTx
  • Auth: one of:
    • API key in header X-API-Key
    • API key in query parameter api_key

Query parameters

sourcestring required

Account address in raw format (e.g., 0:ca6e321c...) or user-friendly format (e.g., EQDKbjIcfM...). All formats are automatically detected.

Source account address.

destinationstring required

Account address in raw format (e.g., 0:ca6e321c...) or user-friendly format (e.g., EQDKbjIcfM...). All formats are automatically detected.

Destination account address.

created_ltstring required

The logical time when the message was created. Available in the created_lt field of message objects.

Response

Returns the transaction matching the given source, destination, and created logical time.

okboolean required

Returns true if the request succeeded; otherwise false. See the error field for details.

@extrastring required
jsonrpcstring

JSON-RPC protocol version identifier.

idstring

Changes

No recorded changes to this operation across all 1 revision of this API.