List DNS records

GET

/dns/{domain}

• Production

Returns all DNS records for a domain owned by the authenticated wallet. Rate limited: 100 requests per hour per wallet.

Authorizations

• bearerAuth

Parameters

Path Parameters

domain

required

string

Fully qualified domain name (e.g. “example.com”)

Responses

200

DNS records returned

object

domain

required

The domain name

string

records

required

List of DNS records

Array<object>

object

id

required

Unique record identifier

string

type

required

DNS record type

string

Allowed values: A AAAA CNAME MX TXT NS SRV CAA

host

required

Record hostname

string

value

required

Record value

string

ttl

required

Time-to-live in seconds

integer

distance

required

MX priority or SRV weight, null for non-MX/SRV records

integer | null

401

Authentication required

object

error

required

Short error description

string

message

required

Human-readable error message

string

code

required

Machine-readable error code

string

403

Ownership denied — wallet does not own this domain

object

error

required

Short error description

string

message

required

Human-readable error message

string

code

required

Machine-readable error code

string

Example

{
  "error": "Forbidden",
  "message": "You do not own this domain",
  "code": "OWNERSHIP_DENIED"
}

429

Rate limit exceeded

object

error

required

Short error description

string

message

required

Human-readable error message

string

code

required

Machine-readable error code

string