Get DNS hosts

List Namecheap DNS host records for a domain managed through this Vee3 account.

← All Domains endpoints · Capability overview

GET/v1/domains/managed/{domain}/dns-hosts

https://api.vee3.io/v1/domains/managed/{domain}/dns-hosts

3 tokens

List Namecheap DNS host records for a domain managed through this Vee3 account.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

domains.get_dns_hosts

Parameters1 field

domainstringRequired

Managed domain name (for example example.com).

Response9 fields

domainstring

Managed domain name.

is_using_namecheap_dnsboolean

Whether the domain currently uses Namecheap DNS.

hostsarrayitems

6 fields

DNS host records. Each item includes host_id, host_name, record_type, address, optional mx_pref, and optional ttl.

host_idstring

Namecheap host record id.

host_namestring

Host label, for example @ or www.

record_typestring

DNS record type.

addressstring

Record value.

mx_prefstring

MX preference when record_type is MX or MXE.

ttlinteger

TTL in seconds.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, domains_not_configured, domains_upstream_error, domain_not_found

Example request

Python

import requests

url = "https://api.vee3.io/v1/domains/managed/{domain}/dns-hosts"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "domain": "my-new-site.com"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample managed DNS host list.

dns_hosts.json

{
  "domain": "my-new-site.com",
  "is_using_namecheap_dns": true,
  "hosts": [
    {
      "host_id": "123",
      "host_name": "@",
      "record_type": "A",
      "address": "203.0.113.10",
      "mx_pref": null,
      "ttl": 1800
    },
    {
      "host_id": "124",
      "host_name": "www",
      "record_type": "CNAME",
      "address": "my-new-site.com.",
      "mx_pref": null,
      "ttl": 1800
    }
  ]
}