Get Omni Transaction Details By Transaction ID (Txid)

Through this endpoint customers can obtain details about an Omni transaction by the transaction's unique identifier. The transaction can return information such as hash, height, time of creation in Unix timestamp, etc.

GET /blockchain-data/{blockchain}/{network}/omni/transactions/{transactionId}

Path Parameters

  • Required
    network string

    Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - "mainnet" is the live network with actual data while networks like "testnet", "ropsten", "rinkeby" are test networks.

    Example : testnet
    Possible Values : mainnet testnet
  • Required
    blockchain string

    Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.

    Example : bitcoin
    Possible Values : bitcoin
  • Required
    transactionId string

    Represents the unique identifier of a transaction, i.e. it could be transactionId in UTXO-based protocols like Bitcoin, and transaction hash in Ethereum blockchain.

    Example : d237ff4a681617b767bf22c4e1e8f5115b95c8c168d6cf53bbdec68529f91ecb

Response schema

200 400 401 402 403 404 409 415 422 429 500
HTTP Status Code: 200
Content-Type: application/json

The request has been successful.

  • Object :

  • Required
    apiVersion string

    Specifies the version of the API that incorporates this endpoint.

    Example : 2.0
  • Required
    requestId string

    Defines the ID of the request. The requestId is generated by Crypto APIs and it's unique for every request.

    Example : 601c1710034ed6d407996b30
  • Optional
    context string

    In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. context is specified by the user.

    Example : You can add any text here
  • Required
    data object
    • Required
      item object
      • Required
        amount string

        Defines the amount of the sent tokens.

        Example : 14.915785
      • Required
        divisible boolean

        Defines whether the attribute can be divisible or not, as boolean. E.g., if it is "true", the attribute is divisible.

        Example : True
      • Required
        minedInBlockHash string

        Represents the hash of the block where this transaction was mined/confirmed for first time. The hash is defined as a cryptographic digital fingerprint made by hashing the block header twice through the SHA256 algorithm.

        Example : 0000000049696aca62d2ea7db9e71aa4f1116ede1eb55f9932e758cc586eb8b6
      • Required
        minedInBlockHeight integer

        Represents the hight of the block where this transaction was mined/confirmed for first time. The height is defined as the number of blocks in the blockchain preceding this specific block.

        Example : 1941239
      • Required
        propertyId integer

        Represents the identifier of the tokens to send.

        Example : 2
      • Required
        recipients array

        Represents an object of addresses that receive the transactions.

        • Required
          address string

          Represents the hash of the address that receives the funds.

          Example : ms4KNsbNpoU8g424pzmEjbkFbfAHae1msB
        • Required
          amount string

          Defines the amount of the received funds as a string.

          Example : 0.1
      • Required
        senders array

        Represents an object of addresses that provide the funds.

        • Required
          address string

          Represents the hash of the address that provides the funds.

          Example : ms4KNsbNpoU8g424pzmEjbkFbfAHae1msB
        • Required
          amount string

          Defines the amount of the sent funds as a string.

          Example : 0.00000546
      • Required
        timestamp integer

        Defines the exact date/time in Unix Timestamp when this transaction was mined, confirmed or first seen in Mempool, if it is unconfirmed.

        Example : 1616423278
      • Required
        transactionId string

        Represents the unique identifier of a transaction, i.e. it could be transactionId in UTXO-based protocols like Bitcoin, and transaction hash in Ethereum blockchain.

        Example : d237ff4a681617b767bf22c4e1e8f5115b95c8c168d6cf53bbdec68529f91ecb
      • Required
        type string

        Defines the type of the transaction as a string.

        Example : Simple Send
      • Required
        typeInt integer

        Defines the type of the transaction as a number.

        Example : 0
      • Required
        valid boolean

        Defines whether the transaction is valid or not, as boolean. E.g. if set to "true", it means the transaction is valid.

        Example : True
      • Required
        version integer

        Defines the specific version.

        Example : 0
      • Required
        fee object
        • Required
          amount string

          Defines the amount of the fee.

          Example : 0.0001
        • Required
          unit string

          Defines the unit of the fee.

          Example : BTC
Try it out

Request Example

GET
https://rest.cryptoapis.io/v2/blockchain-data/bitcoin/testnet/omni/transactions/d237ff4a681617b767bf22c4e1e8f5115b95c8c168d6cf53bbdec68529f91ecb
Headers
Host: https://rest.cryptoapis.io/v2
Content-Type: application/json
X-API-Key: my-api-key

Response Example

{
    "apiVersion": "2.0",
    "requestId": "601c1710034ed6d407996b30",
    "context": "You can add any text here",
    "data": {
        "item": {
            "amount": "14.915785",
            "divisible": true,
            "minedInBlockHash": "0000000049696aca62d2ea7db9e71aa4f1116ede1eb55f9932e758cc586eb8b6",
            "minedInBlockHeight": 1941239,
            "propertyId": 2,
            "recipients": [
                {
                    "address": "ms4KNsbNpoU8g424pzmEjbkFbfAHae1msB",
                    "amount": "0.1"
                }
            ],
            "senders": [
                {
                    "address": "ms4KNsbNpoU8g424pzmEjbkFbfAHae1msB",
                    "amount": "0.00000546"
                }
            ],
            "timestamp": 1616423278,
            "transactionId": "d237ff4a681617b767bf22c4e1e8f5115b95c8c168d6cf53bbdec68529f91ecb",
            "type": "Simple Send",
            "typeInt": 0,
            "valid": true,
            "version": 0,
            "fee": {
                "amount": "0.0001",
                "unit": "BTC"
            }
        }
    }
}