/searchMergeUtxosRequests

1 min

POST

Retrieve all merge UTXOs requests in the system for given parameters.

return: JSON object containing all merge UTXOs requests for the specified filters.

Request Example:

.. code-block::

searchMergeUtxosRequests(
        account_id=1,
        coin_type="BTC"
        )

Response Example:

.. code-block::

{
    "FunctionData": [
        {
            "AccountId": 1,
            "CurrencySymbol": "BTC",
            "Date": 1741623565,
            "Fee": 6,
            "MergeUtxosRequestId": "f219...5028",
            "MergeUtxosRequestOptions": {
                "MaxAmountForUtxoToCollect": "100000000",
                "MaxUtxosPerTransaction": 5,
                "MinAmountForUtxoToCollect": "1"
            },
            "MergeUtxosRequestType": "Merge Utxos",
            "MergeUtxosRequestTypeKey": 0,
            "MergeUtxosTransactionsRequests": [
                {
                    "BaseForMergeUtxosTransactionRequestId": null,
                    "BasedOnMergeUtxosTransactionRequestId": null,
                    "FailureDescription": "Maximum fee per user per frequency...",
                    "MergeUtxosRequestId": "f219...5028",
                    "ReplaceableTransactionsChainCount": 1,
                    "Status": "Failed-Limits",
                    "StatusKey": 1,
                    "TransactionSerialNumber": 1,
                    "TxId": null,
                    "UtxosIds": [
                        {
                            "TxId": "dd2e...2b0e",
                            "VoutIndex": 1
                        },
                        {
                            "TxId": "7882...8888",
                            "VoutIndex": 0
                        }
                    ]
                }
            ]
        }
    ],
    "Meta": {
      "AccessToken": "58f08df6e369fa4d126e1ba5c7f66cf85c9c79df32d05fee8f3c542121c87cf5",
      "Destination": "044fd7dc60304b8aceeb662ce41bf9d9cc132278c0871c0a72fb4f3cecbabb25a86e43ae28dab21a95c64e2db76abdcfffb9bfdeec67a21399cfa5f555f01d054b",
      "Source": "be1f60e490b8ccabcc02a4595817b8edf45905d24944e87b8e3cae27f158df63843bfc4b09d37a5e752017b74ea2d136af272bea210f059e768e1ea8777aaf21e9",
      "Time": "2025-10-19 15:04:13.129"
    }
}

coin_typestringThe symbol of the currency to query merge UTXOs requests.

account_idintegerThe ID of the account to query merge UTXOs requests.

status_keysarray<p>List of indices from TransactionState enum representing the transaction statuses to search for (apiclient/Status/TransactionState.py).</p>

type_filterarrayList of parameter types to filter by.

acceptstringGenerated from available response content types

bodyobjectRequest data for retrieving UTXOs with filtering options.

200success

curl --request POST \
     --url '/searchMergeUtxosRequests?coin_type=BTC&account_id=1' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "AccountId": 1,
     "CoinType": "BTC",
     "MergeUtxosRequestTypeKeys": [
     0
     ],
     "StatusKeys": [
     13
     ],
     "Meta": {
     "FunctionName": "searchMergeUtxosRequests",
     "RandomData": "288cd49d4b8bf00e7d6114b78d5668d5581d6b953fafef779133caa844cd4229",
     "Destination": "b9cb8afe52f1d52521cf2b62dfe12146156ad5328f83c62c20c7da81b263356a61340de745c858998544c041798b01c2f4fac31bebe52a19280a32cd57d6d374ea",
     "Time": "2021-02-07T18:37:46.948Z",
     "Source": "048b99461a70a49abe63fd585cb224177a22a92d2e9e4ddfbc0027887bee9d1843388f42a3eb2e740565e115ad8b7981abf59e3b03b771f4b063b53c517d7a9d99",
     "AccessToken": "51311c84d2c8fd2fafbe56ceb1fb30a99d3417abfc55769577338ab286798087"
     }
     }'