Skip to main content
GET
/
api
/
v3
/
dns
/
records
Get DNS Records
curl --request GET \
  --url https://toncenter.com/api/v3/dns/records
{
  "address_book": {},
  "records": [
    {
      "dns_next_resolver": "<string>",
      "dns_site_adnl": "<string>",
      "dns_storage_bag_id": "<string>",
      "dns_wallet": "<string>",
      "domain": "<string>",
      "nft_item_address": "<string>",
      "nft_item_owner": "<string>"
    }
  ]
}

​
SDK Usage

import asyncio

from toncenter.rest import ToncenterRestClient
from toncenter.types import Network

DOMAIN = "ness.ton"


async def main() -> None:
    async with ToncenterRestClient(network=Network.MAINNET) as client:
        result = await client.v3.dns.get_dns_records(
            domain=DOMAIN,
        )
        print(result.model_dump_json(indent=4))


if __name__ == "__main__":
    asyncio.run(main())

Query Parameters

​
wallet
string

Wallet address in any form. DNS records that contain this address in wallet category will be returned.

​
domain
string

Domain name to search for. DNS records with this exact domain name will be returned.

​
limit
integer
default:100

Limit number of queried rows. Use with offset to batch read.

​
offset
integer
default:0

Skip first N rows. Use with limit to batch read.

Response

OK

​
address_book
object
​
records
object[]