TON DocsTON Docs
OnboardingNodesApplicationsAPIsContractsSmart contractsTolkTolk languageTVMTON Virtual MachineFoundationsBlockchain foundations

Resolve TON DNS name

GET
/api/v2/dnsResolve

Recursively resolve a TON DNS domain into all records. Supports .ton, .t.me, and delegated subdomains. When resolver_address is omitted, discover the root from on-chain config parameter 4. Root discovery and all resolver calls use the same masterchain block, selected by seqno or the current state.

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

domain*string

Domain to resolve; relative to resolver_address when supplied. Case-insensitive; a trailing dot is accepted.

resolver_address?string

Starting resolver address. Defaults to on-chain config parameter 4 at the selected block.

seqno?integer

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.

Formatint32

Response Body

application/json

application/json

curl -X GET "https://example.com/api/v2/dnsResolve?domain=string"
{  "ok": true,  "result": {    "@type": "dns.resolved",    "entries": [      {        "@type": "dns.entry",        "name": "string",        "category": "string",        "entry": {          "@type": "dns.entryDataUnknown",          "bytes": "string"        }      }    ]  },  "@extra": "string"}