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.

GET /api/v2/detectAddress

Try it

Detect address

cURL

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

200

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

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.

Response

200

application/json

OK

Response containing all address format variants.

ok · boolean · default: true · required

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

result · object · required

The response data. Only present when ok is true.

Show child attributes

result. @type · enum<string> · default: ext.utils.detectedAddress · required

Object type identifier.

Available options: ext.utils.detectedAddress

result. raw_form · string · required

Raw address format (workchain:hex).

result. bounceable · object · required

Bounceable address format.

Show child attributes

result.bounceable. @type · enum<string> · default: ext.utils.detectedAddressVariant · required

Object type identifier.

Available options: ext.utils.detectedAddressVariant

result.bounceable. b64 · string · required

Standard base64 encoding.

result.bounceable. b64url · string · required

URL-safe base64 encoding.

result. non_bounceable · object · required

Non-bounceable address format.

Show child attributes

result.non_bounceable. @type · enum<string> · default: ext.utils.detectedAddressVariant · required

Object type identifier.

Available options: ext.utils.detectedAddressVariant

result.non_bounceable. b64 · string · required

Standard base64 encoding.

result.non_bounceable. b64url · string · required

URL-safe base64 encoding.

result. given_type · enum<string> · required

Address format that was provided.

Available options: raw_form, friendly_bounceable, friendly_non_bounceable

result. test_only · boolean · required

True if this is a testnet address.

@extra · string

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