Skip to main content

​
Get Transfer

Retrieve the full details of a transfer by its ID, including current status, source and destination details, and fee breakdown.

​
Endpoint

GET /v1/transfers/:id

​
Request

curl https://api.thiqwave.com/v1/transfers/txn_01HZ5NM2XDQE8F1G7HKRWS4JV \
  -H "X-API-Key: your_api_key"

​
Response

{
  "id": "txn_01HZ5NM2XDQE8F1G7HKRWS4JV",
  "quote_id": "quote_abc123",
  "status": "completed",
  "source": {
    "currency": "AED",
    "payment_rail": "bank_transfer",
    "amount": "1000.00"
  },
  "destination": {
    "currency": "USDC",
    "network": "sui",
    "address": "0x8a4c5b9e1f3d7a2c6e0b4f8d9a1c3e5f7b2d4a6c8e0f1a3b5d7e9c2a4b6d8f",
    "amount": "271.50"
  },
  "fees": {
    "platform_fee": "2.50",
    "network_fee": "0.10"
  },
  "exchange_rate": "0.2715",
  "payment_instructions": {
    "beneficiary_name": "Thiqwave Limited",
    "beneficiary_account": "1234567890",
    "bank_code": "ABUAAE3D",
    "reference": "txn_01HZ5NM2XDQE8F1G7HKRWS4JV",
    "country": "AE"
  },
  "metadata": {},
  "created_at": "2026-04-13T10:30:00Z",
  "completed_at": "2026-04-13T10:35:00Z"
}

​
Response Fields

FieldTypeDescription
idstringUnique transfer identifier.
quote_idstringAssociated quote.
statusstringCurrent status: pending, awaiting_deposit, processing, settling, completed, failed.
sourceobjectSource details including currency, network/payment rail, and resolved amount.
destinationobjectDestination details including currency, network/account, and resolved amount.
feesobjectPlatform and network fee breakdown.
exchange_ratestringApplied conversion rate.
payment_instructionsobject or nullBank deposit instructions (present only for fiat-source transfers).
metadataobjectYour metadata.
created_atstringISO 8601 creation timestamp.
completed_atstring or nullISO 8601 completion timestamp.

​
Notes

  • Check the status field to determine the current state of the transfer.
  • Use the id to track the transaction in your system.
  • Once status becomes completed, funds have been delivered to the destination.
  • For fiat-source transfers in awaiting_deposit status, use the payment_instructions to complete the bank deposit.