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.

POST /api/v2/getAddressState

Try it

Get address state

cURL

curl --request POST \
  --url https://toncenter.com/api/v2/getAddressState \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "address": "<string>",
  "seqno": "<string>"
}
'

200

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

Authorizations

X-API-Key · string · header · required

Body

application/json

address · string · required

The account address in user-friendly format.

seqno

Block or wallet sequence number. For blocks, this is the block height. For wallets, increment this for each outgoing transaction.

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.