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). Refer to the account lifecycle states documentation for details. Check this before interacting with a contract.
API key header of the form X-API-Key: <token>, where <token> is the API key. Requests without a key are limited to 1 RPS. Refer to the authentication guide for details.
In: header
Query Parameters
The account address to query.
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 Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v2/getAddressState?address=string"{
"ok": true,
"result": "uninitialized",
"@extra": "string"
}{
"ok": false,
"code": 401,
"error": "API key does not exist"
}{
"ok": false,
"code": 403,
"error": "Network not allowed"
}{
"ok": false,
"code": 422,
"error": "empty address"
}{
"ok": false,
"code": 429,
"error": "Ratelimit exceeded"
}{
"ok": false,
"code": 504,
"error": "LITE_SERVER_NETWORK timeout"
}