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

# Try Locate Tx

> Try to locate outcoming transaction of __destination__ address by incoming message



## OpenAPI

````yaml GET /api/v2/tryLocateTx
openapi: 3.1.1
info:
  title: TON HTTP API C++
  description: >
    This API enables HTTP access to TON blockchain - getting accounts and
    wallets information, looking up blocks and transactions, sending messages to
    the blockchain, calling get methods of smart contracts, and more.


    In addition to REST API, all methods are available through [JSON-RPC
    endpoint](#json%20rpc)  with `method` equal to method name and `params`
    passed as a dictionary.


    The response contains a JSON object, which always has a boolean field `ok`
    and either `error` or `result`. If `ok` equals true, the request was
    successful and the result of the query can be found in the `result` field.
    In case of an unsuccessful request, `ok` equals false and the error is
    explained in the `error`.


    API Key should be sent either as `api_key` query parameter or `X-API-Key`
    header
  version: 2.1.1
servers:
  - url: https://toncenter.com
    description: Mainnet
  - url: https://testnet.toncenter.com
    description: Testnet
security: []
tags:
  - name: utils
    description: Some useful methods
  - name: accounts
    description: Information about accounts
  - name: blocks
    description: Information about blocks
  - name: transactions
    description: Fetching and locating transactions
  - name: configuration
    description: Information about blockchain config
  - name: run method
    description: Run get-method of smart contracts
  - name: send
    description: Send data to blockchain
  - name: rpc
    description: JSON-RPC and POST endpoints
paths:
  /api/v2/tryLocateTx:
    get:
      tags:
        - transactions
      summary: Try Locate Transaction
      description: >-
        Try to locate outcoming transaction of __destination__ address by
        incoming message
      operationId: tryLocateTx_get
      parameters:
        - $ref: '#/components/parameters/sourceAddress'
        - $ref: '#/components/parameters/destinationAddress'
        - $ref: '#/components/parameters/createdLt'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    example: true
                  result:
                    title: TransactionStd
                    allOf:
                      - $ref: '#/components/schemas/TransactionStd'
                required:
                  - ok
                  - result
        default:
          $ref: '#/components/responses/default'
components:
  parameters:
    sourceAddress:
      name: source
      in: query
      description: Source address
      required: true
      schema:
        $ref: '#/components/schemas/TonAddr'
    destinationAddress:
      name: destination
      in: query
      description: Destination address
      required: true
      schema:
        $ref: '#/components/schemas/TonAddr'
    createdLt:
      name: created_lt
      in: query
      description: Creation logical time of a message
      required: true
      schema:
        type: string
        x-usrv-cpp-type: std::int64_t
  schemas:
    TransactionStd:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - raw.transaction
          default: raw.transaction
        address:
          $ref: '#/components/schemas/AccountAddress'
        utime:
          type: integer
          description: UNIX timestamp of transaction
        data:
          $ref: '#/components/schemas/Bytes'
        transaction_id:
          $ref: '#/components/schemas/InternalTransactionId'
        fee:
          $ref: '#/components/schemas/Int256'
        storage_fee:
          $ref: '#/components/schemas/Int256'
        other_fee:
          $ref: '#/components/schemas/Int256'
        in_msg:
          $ref: '#/components/schemas/MessageStd'
        out_msgs:
          type: array
          items:
            $ref: '#/components/schemas/MessageStd'
      required:
        - '@type'
        - address
        - utime
        - data
        - transaction_id
        - fee
        - storage_fee
        - other_fee
        - out_msgs
    TonAddr:
      type: string
      x-usrv-cpp-type: ton_http::types::ton_addr
    AccountAddress:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - accountAddress
          default: accountAddress
        account_address:
          type: string
          x-usrv-cpp-type: ton_http::types::ton_addr
    Bytes:
      type: string
      x-usrv-cpp-type: ton_http::types::bytes
    InternalTransactionId:
      type: object
      additionalProperties: false
      description: Internal transaction identifier.
      properties:
        '@type':
          type: string
          enum:
            - internal.transactionId
          default: internal.transactionId
        lt:
          type: string
          description: Logical time
          x-usrv-cpp-type: std::int64_t
        hash:
          $ref: '#/components/schemas/TonHash'
      required:
        - '@type'
        - lt
        - hash
    Int256:
      type: string
      x-usrv-cpp-type: ton_http::types::int256
    MessageStd:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - raw.message
          default: raw.message
        hash:
          $ref: '#/components/schemas/TonHash'
        source:
          $ref: '#/components/schemas/AccountAddress'
        destination:
          $ref: '#/components/schemas/AccountAddress'
        value:
          $ref: '#/components/schemas/Int256'
        extra_currencies:
          type: array
          items:
            $ref: '#/components/schemas/ExtraCurrencyBalance'
        fwd_fee:
          $ref: '#/components/schemas/Int256'
        ihr_fee:
          $ref: '#/components/schemas/Int256'
        created_lt:
          type: string
          description: Logical time of the transaction
          x-usrv-cpp-type: std::int64_t
        body_hash:
          $ref: '#/components/schemas/TonHash'
        msg_data:
          $ref: '#/components/schemas/MsgData'
      required:
        - '@type'
        - hash
        - source
        - destination
        - value
        - extra_currencies
        - fwd_fee
        - ihr_fee
        - created_lt
        - body_hash
        - msg_data
    TonlibErrorResponse:
      type: object
      additionalProperties: false
      title: TonlibErrorResponse
      required:
        - ok
        - error
        - code
      properties:
        ok:
          type: boolean
          title: Ok
          default: false
        error:
          type: string
          title: Error description
        code:
          type: integer
          title: Error code
          minimum: 100
          maximum: 600
        '@extra':
          type: string
          title: Extra information
        jsonrpc:
          type: string
        id:
          type: string
    TonHash:
      type: string
      x-usrv-cpp-type: ton_http::types::ton_hash
    ExtraCurrencyBalance:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - extraCurrency
          default: extraCurrency
        id:
          type: integer
          format: int32
        amount:
          $ref: '#/components/schemas/Int256'
      required:
        - '@type'
        - id
        - amount
    MsgData:
      oneOf:
        - $ref: '#/components/schemas/MsgDataRaw'
        - $ref: '#/components/schemas/MsgDataText'
        - $ref: '#/components/schemas/MsgDataDecryptedText'
        - $ref: '#/components/schemas/MsgDataEncryptedText'
      discriminator:
        propertyName: '@type'
        mapping:
          msg.dataRaw:
            $ref: '#/components/schemas/MsgDataRaw'
          msg.dataText:
            $ref: '#/components/schemas/MsgDataText'
          msg.dataDecryptedText:
            $ref: '#/components/schemas/MsgDataDecryptedText'
          msg.dataEncryptedText:
            $ref: '#/components/schemas/MsgDataEncryptedText'
    MsgDataRaw:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - msg.dataRaw
          default: msg.dataRaw
        body:
          $ref: '#/components/schemas/Bytes'
        init_state:
          $ref: '#/components/schemas/Bytes'
    MsgDataText:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - msg.dataText
          default: msg.dataText
        text:
          $ref: '#/components/schemas/Bytes'
    MsgDataDecryptedText:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - msg.dataDecryptedText
          default: msg.dataDecryptedText
        text:
          $ref: '#/components/schemas/Bytes'
    MsgDataEncryptedText:
      type: object
      additionalProperties: false
      properties:
        '@type':
          type: string
          enum:
            - msg.dataEncryptedText
          default: msg.dataEncryptedText
        text:
          $ref: '#/components/schemas/Bytes'
  responses:
    default:
      description: Tonlib error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/TonlibErrorResponse'
          examples:
            '409':
              summary: Not a token
              value:
                ok: false
                code: 409
                error: Smart contract is not a Jetton or NFT
                '@extra': ...
            '422':
              summary: Request validation error
              value:
                ok: false
                code: 422
                error: ...
                '@extra': ...
            '429':
              summary: Ratelimit exceeded
              value:
                ok: false
                code: 429
                error: ...
                '@extra': ...
            '504':
              summary: Tonlib timeout
              value:
                ok: false
                code: 504
                error: ...
                '@extra': ...

````