Skip to main content
GET
/
v1
/
transactions
/
{txId}
Get Transaction
curl --request GET \
  --url https://api.example.com/v1/transactions/{txId}
{
  "transaction": {
    "txId": "<string>",
    "tenantId": "<string>",
    "projectId": "<string>",
    "walletId": "<string>",
    "accountId": "<string>",
    "fromAddress": "<string>",
    "toAddress": "<string>",
    "amount": "<string>",
    "chainReference": "<string>",
    "txHash": "<string>",
    "status": 123,
    "unsignedTxHex": "<string>",
    "signedTxHex": "<string>",
    "metadata": {},
    "createAt": "<string>",
    "updateAt": "<string>"
  }
}

Get Transaction

Retrieve detailed information about a transaction including its current status.

Request

txId
string
required
Transaction identifier

Response

transaction
object

Example

curl -X GET https://api.axonvault.io/v1/transactions/tx_abc123 \
  -H "X-Access-Key: ak_live_abc123" \
  -H "X-Signature: 5d41402abc4b2a76b9719d911017c592" \
  -H "X-Timestamp: 2024-01-15T10:30:00Z"

Response Example

{
  "transaction": {
    "txId": "tx_abc123",
    "tenantId": "ten_abc123",
    "projectId": "proj_abc123",
    "walletId": "wlt_srv_abc123",
    "accountId": "acc_abc123",
    "fromAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE8d",
    "toAddress": "0x1234567890123456789012345678901234567890",
    "amount": "1000000000000000000",
    "chainReference": "eip155:1",
    "txHash": "0x1234567890abcdef...",
    "status": 2,
    "metadata": {
      "nonce": "10",
      "gasLimit": "21000",
      "gasPrice": "20000000000",
      "chainId": "1"
    },
    "createAt": "2024-01-15T10:30:00Z",
    "updateAt": "2024-01-15T10:35:00Z"
  }
}

Transaction Status

StatusNameDescription
0PendingTransaction built, not yet signed
1SubmittedBroadcast to network, awaiting confirmation
2ConfirmedIncluded in block with sufficient confirmations
3FailedTransaction failed or reverted

Errors

Error TypeStatusDescription
unauthorized401Invalid credentials
not_found404Transaction not found