Get Account

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

string

required

Your Thiqwave API key.

Path parameters

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"

const accountId = 'acc_01HZ5NM2XDQE8F1G7HKRWS4JV';

const response = await fetch(`https://api.thiqwave.com/v1/accounts/${accountId}`, {
  headers: {
    'X-API-Key': 'your-api-key',
  },
});

const account = await response.json();

import requests

account_id = 'acc_01HZ5NM2XDQE8F1G7HKRWS4JV'

response = requests.get(
    f'https://api.thiqwave.com/v1/accounts/{account_id}',
    headers={'X-API-Key': 'your-api-key'},
)

account = response.json()

Response

A 200 OK response returns the full account object with live balance information.

string

The unique account ID.

string

The account type: "fiat" or "stablecoin".

string

The current account status: "active", "frozen", or "closed".

string

The account currency code.

string

For fiat accounts: the corridor code.

string

For stablecoin wallets: the blockchain network.

string

For stablecoin wallets: "mpc" or "self_custody".

string

For stablecoin wallets: the blockchain address.

object

The current balance of the account.

Show Balance fields

string|number

The amount available for immediate use. For fiat: smallest currency unit (integer). For stablecoin: human-readable string (e.g., “12500.50”).

string|number

The amount held in pending transactions. For fiat: smallest currency unit (integer). For stablecoin: human-readable string.

string

Friendly name for the account.

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": "mpc",
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0",
  "balance": {
    "available": "12500.50",
    "pending": "1000.00"
  },
  "label": "USDC Polygon Treasury",
  "created_at": "2026-04-08T12:00:00Z"
}

Error responses

Status	Code	Description
`401`	`UNAUTHORIZED`	Your API key is missing or invalid.
`403`	`FORBIDDEN`	You do not have permission to access this account.
`404`	`ACCOUNT_NOT_FOUND`	No account exists with the given ID.

Overview

Transfers

Quotes

Accounts & Wallets

Partners

Compliance

Granular Endpoints

Endpoint

Description

Request

Headers

Path parameters

Example requests

Response

Example response (fiat)

Example response (stablecoin)

Error responses

​Endpoint

​Description

​Request

​Headers

​Path parameters

​Example requests

​Response

​Example response (fiat)

​Example response (stablecoin)

​Error responses

Endpoint

Description

Request

Headers

Path parameters

Example requests

Response

Example response (fiat)

Example response (stablecoin)

Error responses