TON DocsTON Docs
OnboardingNodesApplicationsAPIsSmart contractsTolkTolk languageTVMTON Virtual MachineFoundationsBlockchain foundations

Detect address

Validates an address and returns it in all standard formats. Use this to convert between address formats or to validate user input. Returns raw format (0:abc), base64 bounceable (EQ), base64 non-bounceable (UQ), and URL-safe variants.

Authorization

X-API-Key<token>

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

address*string

The account address to query.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v2/detectAddress?address=string"
{
  "ok": true,
  "result": {
    "@type": "ext.utils.detectedAddress",
    "raw_form": "string",
    "bounceable": {
      "@type": "ext.utils.detectedAddressVariant",
      "b64": "string",
      "b64url": "string"
    },
    "non_bounceable": {
      "@type": "ext.utils.detectedAddressVariant",
      "b64": "string",
      "b64url": "string"
    },
    "given_type": "raw_form",
    "test_only": true
  },
  "@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"
}