> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# tryLocateTx | TON v2

> The tryLocateTx method attempts to locate a specific transaction in the TON blockchain based on the source address, destination address.

The `tryLocateTx` method attempts to locate a specific transaction in the TON blockchain based on the source address, destination address, and the logical time when the transaction was created. This method is useful for finding detailed information about a transaction when you have partial information about it.

<Note>
  **TON billing: full (1 RU)**

  This method is always billed as full. See [Request units — TON method scope](/docs/request-units#ton-method-scope).
</Note>

## Parameters

* `source` (string, required) — The source address of the transaction. Example: `UQAX2d4C2d48JeA-0y2_peGabRVumnKY22xPvkuEayC3zTI1`.
* `destination` (string, required) — The destination address of the transaction. Example: `UQBP4mzpDIywL1SV-Wp9ZuBBlzprR9eXQgSYGEXiUEHm73vA`.
* `created_lt` (string, required) — The logical time when the transaction was created. Example: `47597573000002`.

## JSON-RPC example

```shell Shell theme={"system"}
curl -X POST \
  'https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/jsonRPC' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tryLocateTx",
    "params": {
      "source": "UQAX2d4C2d48JeA-0y2_peGabRVumnKY22xPvkuEayC3zTI1",
      "destination": "UQBP4mzpDIywL1SV-Wp9ZuBBlzprR9eXQgSYGEXiUEHm73vA",
      "created_lt": "47597573000002"
    }
  }'
```

## Response

* `block` (object) — Information about the block containing the transaction:
  * `workchain` (integer) — The workchain ID of the block.
  * `shard` (string) — The shard ID of the block.
  * `seqno` (integer) — The sequence number of the block.
  * `root_hash` (string) — The root hash of the block.
  * `file_hash` (string) — The file hash of the block.
* `transaction_id` (object) — The identifier of the transaction:
  * `lt` (string) — The logical time of the transaction.
  * `hash` (string) — The hash of the transaction.

## Use case

A possible use case for the `tryLocateTx` method in TON is for blockchain explorers, wallet applications, or any service that needs to locate a specific transaction with partial information. This method can be used to:

1. Find the full details of a transaction when only the source, destination, and approximate time are known.
2. Verify the existence and details of a transaction in dispute resolution scenarios.
3. Implement advanced search functionality in blockchain explorers.
4. Cross-reference transactions across different data sources or systems.


## OpenAPI

````yaml openapi/ton_node_api/v2/tryLocateTx.json GET /tryLocateTx
openapi: 3.0.0
info:
  title: tryLocateTx example
  version: 1.0.0
  description: >-
    This is an API example for tryLocateTx, a method to locate a transaction in
    the TON blockchain based on source, destination, and logical time.
servers:
  - url: >-
      https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2
security: []
paths:
  /tryLocateTx:
    get:
      tags:
        - TON Operations
      summary: tryLocateTx
      operationId: tryLocateTx
      parameters:
        - name: source
          in: query
          required: true
          description: The source address of the transaction
          schema:
            type: string
            default: UQAX2d4C2d48JeA-0y2_peGabRVumnKY22xPvkuEayC3zTI1
          example: UQAX2d4C2d48JeA-0y2_peGabRVumnKY22xPvkuEayC3zTI1
        - name: destination
          in: query
          required: true
          description: The destination address of the transaction
          schema:
            type: string
            default: UQBP4mzpDIywL1SV-Wp9ZuBBlzprR9eXQgSYGEXiUEHm73vA
          example: UQBP4mzpDIywL1SV-Wp9ZuBBlzprR9eXQgSYGEXiUEHm73vA
        - name: created_lt
          in: query
          required: true
          description: The logical time when the transaction was created
          schema:
            type: string
            default: '47597573000002'
          example: '47597573000002'
      responses:
        '200':
          description: Information about the located transaction
          content:
            application/json:
              schema:
                type: object
                properties:
                  block:
                    type: object
                    properties:
                      workchain:
                        type: integer
                        description: >-
                          The workchain ID of the block containing the
                          transaction
                      shard:
                        type: string
                        description: The shard ID of the block containing the transaction
                      seqno:
                        type: integer
                        description: >-
                          The sequence number of the block containing the
                          transaction
                      root_hash:
                        type: string
                        description: The root hash of the block containing the transaction
                      file_hash:
                        type: string
                        description: The file hash of the block containing the transaction
                  transaction_id:
                    type: object
                    properties:
                      lt:
                        type: string
                        description: The logical time of the transaction
                      hash:
                        type: string
                        description: The hash of the transaction

````