Skip to main content

​
Endpoint

GET https://api.thiqwave.com/v1/accounts/:id

​
Description

Retrieve the details of a specific settlement account or wallet, including its current status and live balance. Use this endpoint to check account state, confirm wallet addresses, or display account information to your users.

​
Request

​
Headers

​
X-API-Key
string
required
Your Thiqwave API key.

​
Path parameters

​
id
string
required
The unique account ID returned when the account was created.

​
Example requests

curl https://api.thiqwave.com/v1/accounts/acc_01HZ5NM2XDQE8F1G7HKRWS4JV \
  -H "X-API-Key: your-api-key"

​
Response

A 200 OK response returns the full account object with live balance information.
​
id
string
The unique account ID.
​
type
string
The account type: "fiat" or "stablecoin".
​
status
string
The current account status: "active", "frozen", or "closed".
​
currency
string
The account currency code.
​
corridor
string
For fiat accounts: the corridor code.
​
network
string
For stablecoin wallets: the blockchain network.
​
wallet_mode
string
For stablecoin wallets: "managed" or "external".
​
address
string
For stablecoin wallets: the blockchain address.
​
balance
object
The current balance of the account.
​
label
string
Friendly name for the account.
​
created_at
string
The ISO 8601 timestamp of when the account was created.

​
Example response (fiat)

{
  "id": "acc_01HZ5NM2XDQE8F1G7HKRWS4JV",
  "type": "fiat",
  "status": "active",
  "currency": "AED",
  "corridor": "uae",
  "balance": {
    "available": 500000,
    "pending": 50000
  },
  "label": "UAE Operations",
  "created_at": "2026-04-01T10:00:00Z"
}

​
Example response (stablecoin)

{
  "id": "acc_02HZ5NM2XDQE8F1G7HKRWS4JV",
  "type": "stablecoin",
  "status": "active",
  "currency": "USDC",
  "network": "polygon",
  "wallet_mode": "managed",
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0",
  "balance": {
    "available": "12500.50",
    "pending": "1000.00"
  },
  "label": "USDC Polygon Treasury",
  "created_at": "2026-04-08T12:00:00Z"
}

​
Error responses

StatusCodeDescription
401UNAUTHORIZEDYour API key is missing or invalid.
403FORBIDDENYou do not have permission to access this account.
404ACCOUNT_NOT_FOUNDNo account exists with the given ID.