Unpack address

Converts a user-friendly base64 address back to its raw components. Returns the workchain ID, account hex, and flags indicating if the address is bounceable or testnet-only.

GET /api/v2/unpackAddress

Try it

Unpack address

cURL

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

200

{
  "ok": true,
  "result": {
    "workchain": 123,
    "bounceable": true,
    "testnet": true,
    "addr_hex": "<string>"
  },
  "@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 the unpacked raw address components.

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. workchain · integer

Workchain ID: -1 for masterchain, 0 for basechain. Most user transactions are on workchain 0.

result. bounceable · boolean

Whether the address is bounceable.

result. testnet · boolean

Whether the address is for testnet.

result. addr_hex · string

Account ID in hexadecimal format.

@extra · string

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