# Get Account

> Documentation index: [llms.txt](https://namera.ai/llms.txt).

Source: https://namera.ai/docs/sdk/reference/accounts/get-account

Read one account by its ID.

`namera.wallets.get(walletId)` returns an account available to your credential.

## Usage [#usage]

Install `@namera-ai/sdk` and set `NAMERA_API_KEY`. Replace example IDs with resources available to your credential.

<Tabs items={["index.ts", "client.ts"]}>
<Tab value="index.ts">

```ts title="index.ts"
import { namera } from "./client";
const result = await namera.wallets.get("0199dfe1-0000-7000-8000-000000000001");
if (!result.success) throw new Error(result.error.message);

console.log(result.data);
```

</Tab>
<Tab value="client.ts">

```ts title="client.ts"
import { NameraClient } from "@namera-ai/sdk";

export const namera = new NameraClient({
  apiKey: process.env.NAMERA_API_KEY!,
});
```

</Tab>
</Tabs>

## Returns [#returns]

API methods return a `Promise<NameraResult<T, E>>`. When `success` is `true`,
`data` contains the value described below and `error` is `null`. On failure,
`data` is `null` and `error` describes the failure.

The JSON example shows the complete successful `data`, with illustrative values.
Date-time values use ISO strings in JSON; bigint values use decimal strings.
See [Handling Results and Errors](https://namera.ai/docs/sdk/handling-results-and-errors) for the error shape.

- **`id`** (`string`): Account ID.
- **`organizationId`** (`string`): Owning organization ID.
- **`metadata`** (`object`): version and name, with optional logo and description.
- **`status`** (`"active" | "frozen" | "archived"`): Account lifecycle status.
- **`namespace`** (`"eip155"`): Chain namespace.
- **`address`** (`` `0x${string}` ``): Smart-account address.
- **`owner`** (`object`): Public signing-key identity, custody, algorithm, and provider-specific protection details.
- **`implementation`** (`"alchemy-modular-v2"`): Smart-account implementation.
- **`data`** (`object`): Account configuration, discriminated by validatorType and accountMode. Includes deployment and version fields.
- **`createdAt`** (`DateTime.Utc`): Creation time.
- **`updatedAt`** (`DateTime.Utc`): Last update time.

### Example Response [#example-response]

<div className="docs-response">

```json
{
  "id": "0199dfe1-0000-7000-8000-000000000001",
  "organizationId": "0199dfe1-0000-7000-8000-000000000004",
  "metadata": {
    "version": 1,
    "name": "Example account",
    "logo": {
      "type": "emoji",
      "value": "👛"
    },
    "description": "SDK test account"
  },
  "status": "active",
  "namespace": "eip155",
  "address": "0x1111111111111111111111111111111111111111",
  "owner": {
    "signingKeyId": "0199dfe1-0000-7000-8000-000000000005",
    "custody": "namera-managed",
    "provider": "1claw",
    "algorithm": "secp256k1"
  },
  "implementation": "alchemy-modular-v2",
  "data": {
    "version": 1,
    "modularAccountVersion": "2.0.0",
    "validatorType": "ecdsa_secp256k1",
    "entryPointVersion": "0.7",
    "accountMode": "7702",
    "delegationVersion": "v1.1.0"
  },
  "createdAt": "2026-10-11T09:00:00.000Z",
  "updatedAt": "2026-10-11T09:00:00.000Z"
}
```

</div>

## Parameters [#parameters]

### walletId [#walletid]

- **Type:** `string`
- **Required**

The account UUID returned by `wallets.list()` or `wallets.get()`. Pass its `id`,
not its onchain `address`. The account must be accessible to the client’s credential.

```ts title="index.ts"
import { namera } from "./client";
const result = await namera.wallets.get("0199dfe1-0000-7000-8000-000000000001"); // [!code focus]
if (!result.success) throw new Error(result.error.message);

console.log(result.data);
```

## Errors [#errors]

`WALLET_NOT_FOUND` means the account does not exist or is not available to your credential. See [Handling Results and Errors](https://namera.ai/docs/sdk/handling-results-and-errors)
for authentication, transport, and contract errors.