---
title: "POST /EXPERIMENTAL_view_account"
method: POST
path: "/EXPERIMENTAL_view_account"
---

# POST /EXPERIMENTAL_view_account

`POST /EXPERIMENTAL_view_account`

Returns information about an account for given account_id.

## Request body

- JsonRpcRequestForEXPERIMENTALViewAccount
  - `id` string — JSON-RPC request id. Auto-populated; can be any string.
  - `jsonrpc` '2.0' — JSON-RPC protocol version. Always `2.0`.
  - `method` 'EXPERIMENTAL_view_account', required
  - `params` union, required
    - object
      - `block_id` union, required
        - integer
        - string
      - `account_id` string, required — NEAR Account Identifier. This is a unique, syntactically valid, human-readable account identifier on the NEAR network. [See the crate-level docs for information about validation.](index.html#account-id-rules) Also see [Error kind precedence](AccountId#error-kind-precedence). ## Examples ``` use near_account_id::AccountId; let alice: AccountId = "alice.near".parse().unwrap(); assert!("ƒelicia.near".parse::<AccountId>().is_err()); // (ƒ is not f) ```
    - object
      - `finality` 'optimistic' | 'near-final' | 'final', required — Different types of finality.
      - `account_id` string, required — NEAR Account Identifier. This is a unique, syntactically valid, human-readable account identifier on the NEAR network. [See the crate-level docs for information about validation.](index.html#account-id-rules) Also see [Error kind precedence](AccountId#error-kind-precedence). ## Examples ``` use near_account_id::AccountId; let alice: AccountId = "alice.near".parse().unwrap(); assert!("ƒelicia.near".parse::<AccountId>().is_err()); // (ƒ is not f) ```
    - object
      - `sync_checkpoint` 'genesis' | 'earliest_available', required
      - `account_id` string, required — NEAR Account Identifier. This is a unique, syntactically valid, human-readable account identifier on the NEAR network. [See the crate-level docs for information about validation.](index.html#account-id-rules) Also see [Error kind precedence](AccountId#error-kind-precedence). ## Examples ``` use near_account_id::AccountId; let alice: AccountId = "alice.near".parse().unwrap(); assert!("ƒelicia.near".parse::<AccountId>().is_err()); // (ƒ is not f) ```

## Response `200`

- union
  - object
    - `result` RpcViewAccountResponse, required — A view of the account
      - `amount` string, required
      - `block_hash` string, required
      - `block_height` integer, required
      - `code_hash` string, required
      - `global_contract_account_id` union — Set when the account uses a global contract referenced by the deploying account id.
        - string — NEAR Account Identifier. This is a unique, syntactically valid, human-readable account identifier on the NEAR network. [See the crate-level docs for information about validation.](index.html#account-id-rules) Also see [Error kind precedence](AccountId#error-kind-precedence). ## Examples ``` use near_account_id::AccountId; let alice: AccountId = "alice.near".parse().unwrap(); assert!("ƒelicia.near".parse::<AccountId>().is_err()); // (ƒ is not f) ```
        - unknown
      - `global_contract_hash` union — Set when the account uses a global contract referenced by code hash.
        - string
        - unknown
      - `locked` string, required
      - `storage_paid_at` integer — Deprecated and unused. TODO(2271): remove.
      - `storage_usage` integer, required — Total storage used by the account, in bytes.
    - `id` string, required
    - `jsonrpc` string, required
  - object
    - `error` union, required
      - object
        - `cause` union, required
          - object
            - `info` object, required
              - …
            - `name` 'METHOD_NOT_FOUND', required
          - object
            - `info` object, required
              - …
            - `name` 'PARSE_ERROR', required
        - `name` 'REQUEST_VALIDATION_ERROR', required
      - object
        - `cause` union, required
          - object
            - `info` object, required
              - …
            - `name` 'UNKNOWN_BLOCK', required
          - object
            - `info` object, required
              - …
            - `name` 'INVALID_ACCOUNT', required
          - object
            - `info` object, required
              - …
            - `name` 'UNKNOWN_ACCOUNT', required
          - object
            - `info` object, required
              - …
            - `name` 'INTERNAL_ERROR', required
        - `name` 'HANDLER_ERROR', required
      - object
        - `cause` InternalError, required
          - `info` object, required
            - `error_message` string, required
          - `name` 'INTERNAL_ERROR', required
        - `name` 'INTERNAL_ERROR', required
    - `id` string, required
    - `jsonrpc` string, required

## Changes

- **2026-08-10** `f586f4853138` — 3 breaking, 3 info
  - the `oneOf[subschema #1]/result/amount` response's property type changed from `string` to no type for status `200`
  - the `oneOf[subschema #1]/result/code_hash` response's property type changed from `string` to no type for status `200`
  - the `oneOf[subschema #1]/result/locked` response's property type changed from `string` to no type for status `200`
  - added `#/components/schemas/CryptoHash` to the `oneOf[subschema #1]/result/code_hash` response property `allOf` list for the response status `200`
  - …2 more
- **2026-05-21** `97b870f1f638` — 1 breaking, 1 info
  - added `subschema #1, subschema #2` to the response body `oneOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the response body `oneOf` list for the response status `200`
- **2026-05-21** `e1982645f483` — 1 breaking, 1 info
  - added `subschema #1, subschema #2` to the response body `oneOf` list for the response status `200`
  - removed `#/components/schemas/JsonRpcResponse_for_RpcViewAccountResponse_and_RpcViewAccountError_variant0, #/components/schemas/JsonRpcResponse_for_RpcViewAccountResponse_and_RpcViewAccountError_variant1` from the response body `oneOf` list for the response status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/near/apis/near-protocol-json-rpc-api/changes/EXPERIMENTAL_view_account/post.md)

---

[API](https://skmtc.dev/near/apis/near-protocol-json-rpc-api.md) · [All operations](https://skmtc.dev/near/apis/near-protocol-json-rpc-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/near/near-protocol-json-rpc-api/revisions/4a6c7147e1c3/schema)