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

# getAddressState | TON v2

> The getAddressState method retrieves the current state of a specific address on the TON blockchain. Use it on TON v2 via Chainstack.

The `getAddressState` method retrieves the current state of a specific address on the TON blockchain. This method provides a quick way to check whether an address is active, uninitialized, or frozen.

<Note>
  **TON billing: full or archive by block age**

  This method is billed as archive (2 RUs) when the requested block is 128 or more seqno behind the tip, and full (1 RU) otherwise. See [Request units — TON method scope](/docs/request-units#ton-method-scope).
</Note>

## JSON-RPC example

```shell Shell theme={"system"}
curl -X POST \
  'https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/jsonRPC' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getAddressState",
    "params": {
      "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2"
    }
  }'
```

## Parameters

* `address` (string, required) — The address for which to retrieve the state. Example: `EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2`.

## Response

* `state` (string) — The current state of the address. Possible values are:
  * `active`: The address is active and can participate in transactions.
  * `uninitialized`: The address has not been initialized yet (no outgoing transactions).
  * `frozen`: The address is frozen and cannot participate in transactions.

## Use case

A possible use case for the `getAddressState` method in TON is for wallet applications, blockchain explorers, or smart contract interactions. This method can be used to:

1. Verify if an address is ready to receive transactions.
2. Check if a smart contract has been deployed and is active.
3. Determine if an address needs to be initialized before use.
4. Monitor the state of important addresses for security or operational purposes.


## OpenAPI

````yaml openapi/ton_node_api/v2/getAddressState.json GET /getAddressState
openapi: 3.0.0
info:
  title: getAddressState example
  version: 1.0.0
  description: >-
    This is an API example for getAddressState, a method to retrieve the current
    state of a specific address on the TON blockchain.
servers:
  - url: >-
      https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2
security: []
paths:
  /getAddressState:
    get:
      tags:
        - TON Operations
      summary: getAddressState
      operationId: getAddressState
      parameters:
        - name: address
          in: query
          required: true
          description: The address to get the state for
          schema:
            type: string
            default: EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2
          example: EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2
      responses:
        '200':
          description: The current state of the specified address
          content:
            application/json:
              schema:
                type: object
                properties:
                  state:
                    type: string
                    description: The current state of the address
                    enum:
                      - active
                      - uninitialized
                      - frozen

````