Get address state

Returns the lifecycle state of an account. Possible values: uninitialized (address has no deployed contract but can receive TON), active (contract is deployed and working), frozen (contract suspended due to zero balance, send TON to unfreeze). Check this before interacting with a contract.

GET /api/v2/getAddressState

Try it

Get address state

cURL

curl --request GET \
  --url https://toncenter.com/api/v2/getAddressState \
  --header 'X-API-Key: <api-key>'

200

{
  "ok": true,
  "result": "uninitialized",
  "@extra": "<string>"
}

Authorizations

X-API-Key · string · header · required

Query Parameters

address · string · required

The account address to query. You can use any format: raw (0:abcd), base64 (EQ), or base64url (UQ). The API automatically detects and converts the format. A TON account address. Accepts raw format (workchain:hex like 0:abc...), base64 bounceable (EQ...), base64 non-bounceable (UQ...), or base64url. All formats are automatically detected.

seqno · integer<int32>

Query state at a specific block height. If omitted, returns the current state. Use this to look up historical data at a specific point in time.

Response

200

application/json

OK

Response containing the account lifecycle state.

ok · boolean · default: true · required

Indicates if the request succeeded. If false, check the error field for details.

result · enum<string> · required

The response data. Only present when ok is true.

Available options: uninitialized, active, frozen

@extra · string

Optional request ID that you can pass in the request and receive back in the response. Useful for matching async responses.