> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thiqwave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Account

> Retrieve details of a settlement account or wallet.

## 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

<ParamField header="X-API-Key" type="string" required>
  Your Thiqwave API key.
</ParamField>

### Path parameters

<ParamField path="id" type="string" required>
  The unique account ID returned when the account was created.
</ParamField>

## Example requests

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.thiqwave.com/v1/accounts/acc_01HZ5NM2XDQE8F1G7HKRWS4JV \
    -H "X-API-Key: your-api-key"
  ```

  ```javascript JavaScript theme={null}
  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();
  ```

  ```python Python theme={null}
  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()
  ```
</CodeGroup>

## Response

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

<ResponseField name="id" type="string">
  The unique account ID.
</ResponseField>

<ResponseField name="type" type="string">
  The account type: `"fiat"` or `"stablecoin"`.
</ResponseField>

<ResponseField name="status" type="string">
  The current account status: `"active"`, `"frozen"`, or `"closed"`.
</ResponseField>

<ResponseField name="currency" type="string">
  The account currency code.
</ResponseField>

<ResponseField name="corridor" type="string">
  For fiat accounts: the corridor code.
</ResponseField>

<ResponseField name="network" type="string">
  For stablecoin wallets: the blockchain network.
</ResponseField>

<ResponseField name="wallet_mode" type="string">
  For stablecoin wallets: `"mpc"` or `"self_custody"`.
</ResponseField>

<ResponseField name="address" type="string">
  For stablecoin wallets: the blockchain address.
</ResponseField>

<ResponseField name="balance" type="object">
  The current balance of the account.

  <Expandable title="Balance fields">
    <ResponseField name="available" type="string|number">
      The amount available for immediate use. For fiat: smallest currency unit (integer). For stablecoin: human-readable string (e.g., "12500.50").
    </ResponseField>

    <ResponseField name="pending" type="string|number">
      The amount held in pending transactions. For fiat: smallest currency unit (integer). For stablecoin: human-readable string.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="label" type="string">
  Friendly name for the account.
</ResponseField>

<ResponseField name="created_at" type="string">
  The ISO 8601 timestamp of when the account was created.
</ResponseField>

### Example response (fiat)

```json theme={null}
{
  "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)

```json theme={null}
{
  "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.               |