Skip to main content
GET
/
account
/
transactions
/
{transactionId}
Get Transaction
curl --request GET \
  --url https://api.fyatu.com/api/v3/account/transactions/{transactionId} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "status": 200,
  "message": "Transaction retrieved successfully",
  "data": {
    "transactionId": "WD1A2B3C4D5E6F7G8H",
    "reference": "TYourTronAddressHere1234567890123",
    "type": "WITHDRAW",
    "amount": 102,
    "fee": 2,
    "currency": "USDT",
    "status": "COMPLETED",
    "description": "Withdrawal request: 100 USDT to TYourTronAddressHere1234567890123 (TRON)",
    "balanceBefore": 1000,
    "balanceAfter": 898,
    "createdAt": "2026-01-05T10:30:00+00:00",
    "updatedAt": "2026-01-05T10:35:00+00:00",
    "withdrawal": {
      "address": "TYourTronAddressHere1234567890123",
      "network": "TRON",
      "netAmount": 100,
      "txHash": "abc123def456..."
    }
  },
  "meta": {
    "requestId": "req_abc123def456",
    "timestamp": "2026-01-05T10:30:00+00:00"
  }
}

Overview

Retrieve details of a specific transaction by its ID. You can use either the transaction ID (batch) or reference to look up the transaction.

Path Parameters

ParameterTypeDescription
transactionIdstringTransaction ID (batch) or reference

Response Fields

FieldTypeDescription
transactionIdstringUnique transaction batch ID
referencestringTransaction reference (e.g., withdrawal address)
typestringTransaction type: CREDIT, DEBIT, or WITHDRAW
amountnumberTransaction amount
feenumberFee charged for the transaction
currencystringTransaction currency (USD or USDT)
statusstringTransaction status
descriptionstringHuman-readable description
balanceBeforenumberBalance before this transaction
balanceAfternumberBalance after this transaction
createdAtstringISO 8601 timestamp of creation
updatedAtstringISO 8601 timestamp of last update

Withdrawal-Specific Fields

For withdrawal transactions (type: "WITHDRAW"), an additional withdrawal object is included:
FieldTypeDescription
withdrawal.addressstringDestination wallet address
withdrawal.networkstringNetwork (TRC20/ERC20)
withdrawal.netAmountnumberNet amount after fee
withdrawal.txHashstringBlockchain transaction hash (when completed)

Transaction Statuses

StatusDescription
PENDINGTransaction is pending processing
PROCESSINGTransaction is being processed
COMPLETEDTransaction completed successfully
FAILEDTransaction failed

Example Usage

// Get by transaction ID
const response = await fetch('https://api.fyatu.com/api/v3/account/transactions/WD123ABC456DEF', {
  headers: {
    'Authorization': `Bearer ${accessToken}`
  }
});

const { data } = await response.json();

console.log(`Transaction ID: ${data.transactionId}`);
console.log(`Type: ${data.type}`);
console.log(`Amount: ${data.currency} ${data.amount}`);
console.log(`Status: ${data.status}`);

// For withdrawal transactions
if (data.withdrawal) {
  console.log(`Sent to: ${data.withdrawal.address}`);
  console.log(`Network: ${data.withdrawal.network}`);
  if (data.withdrawal.txHash) {
    console.log(`TX Hash: ${data.withdrawal.txHash}`);
  }
}

Use Cases

  1. Check withdrawal status: After requesting a withdrawal, poll this endpoint to monitor its progress
  2. Verify transaction: Confirm details of a specific transaction
  3. Get blockchain details: Retrieve the transaction hash once a withdrawal is completed

Authorizations

Authorization
string
header
required

JWT access token obtained from /auth/token

Path Parameters

transactionId
string
required

Transaction ID (batch) or reference

Response

Transaction retrieved successfully

success
boolean
Example:

true

status
integer
Example:

200

message
string
data
object
meta
object