TON DocsTON Docs
APIsTON CenterUtils

Detect address

GET
/api/v2/detectAddress

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"
}