> For the complete documentation index, see [llms.txt](https://roqqu-api-services.gitbook.io/ras/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://roqqu-api-services.gitbook.io/ras/transaction/search-transaction-on-blockchain.md).

# Search Transaction On Blockchain

Search for a transaction on the blockchain by hash and network.

**Endpoint:** `POST /transaction/search-blockchain-txhash`

**Authentication:** Required (`x-api-key` for live, `x-staging-api-key` for test)

#### Request Parameters <a href="#request-parameters-14" id="request-parameters-14"></a>

| Parameter | Type   | Required | Description                                                                                            |
| --------- | ------ | -------- | ------------------------------------------------------------------------------------------------------ |
| tx\_hash  | string | Yes      | Blockchain transaction hash                                                                            |
| network   | string | Yes      | Network code to parse in requests (e.g. `erc20`, `bep20`, `bitcoin`, `trc20`, `solana`, `xrp`, `base`) |

#### **Example Request**

```
curl -X POST https://service.roqqu.com/v1/transaction/search-blockchain-txhash \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "tx_hash=0x9ffd7f17177b6f517195bb5c3e8a769eff276ff56e875ffbba703ee6a940c23b" \
  -d "network=erc20"
```

#### **Example Response (Success)**

Shape varies by network. For EVM networks (`erc20`, `bep20`, `base`), `data` may be a JSON string of the chain receipt:

```
{
  "status": "success",
  "message": "Transaction retrieved successfully",
  "data": "{\"transactionHash\":\"0x9ffd7f...\",\"status\":true,\"blockNumber\":\"123456\"}"
}
```

For networks such as `bitcoin` / `trc20` / `solana` / `xrp`, `data` is typically a parsed object:

```
{
  "status": "success",
  "message": "Transaction retrieved successfully",
  "data": {
    "txid": "52CjcHgQHWC1wvGFRSeJVJ18T2hV7DwPimLR13nktLMKK8PgWM99UyAazTTaDD2fkqiAqGNXA3jes7JzRNoe8buB"
  }
}
```

#### **Error Responses**

**Unsupported network:**

```
{
  "status": "fail",
  "message": "network not supported"
}
```

**Transaction not found on chain:**

```
{
  "status": "fail",
  "message": "Transaction not found"
}
```

**Missing fields:**

```
{
  "status": "fail",
  "message": "(tx_hash) not found in request body"
}
```