# Get an Account

One account with its users and wallets. A user's id reads that user's default account.

## Overview

- `isDefault`: a user's default account — its id is the user's, and it holds the user's wallets that are in no other account. `frozen`: an active freeze of the account; its wallets refuse to sign ([Freeze an Account](https://docs.aureahub.com/docs/guide-accounts.md)).
- `users`: `{ userId, access }`, `owner` or `viewer`; a default account's owner is its user.
- `wallets`: each active wallet it holds — `walletId`, `chain` (the chain it is registered on; `evm` for the EVM key Aurea makes for an account), `family` (`evm` for an EVM chain, else the chain), `isTestnet`, `address`, `keyManagementScheme` (as [Get Wallet](https://docs.aureahub.com/docs/wallets-get.md) answers it), `label` and `isPrimary` (its owner's primary wallet on its chain and network). An EVM address registered on several EVM chains has one entry per chain.
- `createdBy`: who made it; `null` for a default account never written to.
- `404` `ACCOUNT_NOT_FOUND` (`No such account here.`) for an account that is not your tenant's. Same readers as [List Accounts](https://docs.aureahub.com/docs/accounts-list.md).

## Endpoint

### `GET /v1/accounts/{accountId}`

Authentication: bearer token required.

One account with its users and wallets.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `accountId` | string (uuid) | yes | The account's id; a user's id for that user's default account |

**Responses**

`200` OK

```json
{
  "id": "3b8f2c6e-1d4a-4e9b-8f7c-2a5d6e9b1c40",
  "customerRefId": "cust-00042",
  "name": "Savings, customer 42",
  "tags": ["retail", "eu"],
  "hidden": false,
  "isDefault": false,
  "frozen": false,
  "users": [
    { "userId": "5d2c1b0a-9e8f-4a7b-8c6d-5e4f3a2b1c0d", "access": "owner" },
    { "userId": "e4b1c7d9-2f6a-4c83-9b0e-5a7d3f1c8e26", "access": "viewer" }
  ],
  "wallets": [
    {
      "walletId": "7c1e9b24-3f5a-4d8e-9b6c-1a2f3e4d5c6b",
      "chain": "evm",
      "family": "evm",
      "isTestnet": false,
      "address": "0x52908400098527886E0F7030069857D2E4169EE7",
      "keyManagementScheme": "client_side",
      "label": null,
      "isPrimary": false
    },
    {
      "walletId": "4f8a2d6c-1b3e-4a59-8c70-d2e4f6a8b0c1",
      "chain": "solana",
      "family": "solana",
      "isTestnet": false,
      "address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
      "keyManagementScheme": "client_side",
      "label": null,
      "isPrimary": false
    }
  ],
  "createdBy": "0d2f6b8a-4c1e-4a93-b7d5-2e9f1c3a8b60",
  "createdAt": "2026-10-07T09:12:40.511Z",
  "updatedAt": "2026-10-07T09:20:15.730Z"
}
```

`404` Not found

```json
{
  "statusCode": 404,
  "error": "NotFoundError",
  "message": "No such account here.",
  "details": { "code": "ACCOUNT_NOT_FOUND" }
}
```

---

Web version: https://docs.aureahub.com/#account-get