Domains

Domain name research, registration, and managed domains through Vee3. Check purchasable availability, quote and register domains, list and inspect owned domains, manage DNS host records, and research public DNS, WHOIS, RDAP, lookup, and TLD metadata.

GET/v1/domains/dns-records

https://api.vee3.io/v1/domains/dns-records

2 tokens

Look up DNS records for a domain and optional subdomain.

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.dns_records

Parameters2 fields

domainstringRequired

Domain name to look up (for example example.com).

max length 253

subdomainstringOptional

Optional subdomain label to include (for example www or blog).

max length 253

Response5 fields

recordsarrayitems

4 fields

DNS records returned for the domain.

namestring

Record host name.

ttlstring

Time to live in seconds.

typestring

DNS record type (A, AAAA, CNAME, MX, NS, SOA, TXT, …).

datastring

Record value.

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

Example request

Python

import requests

url = "https://api.vee3.io/v1/domains/dns-records"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "domain": "rapidapi.com"
}

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

Example responses1 example

200Sample NS and A records for rapidapi.com.

rapidapi_sample_records.json

[
  {
    "name": "rapidapi.com",
    "ttl": "86400",
    "type": "NS",
    "data": "jim.ns.cloudflare.com"
  },
  {
    "name": "rapidapi.com",
    "ttl": "300",
    "type": "A",
    "data": "172.66.41.24"
  }
]

GET/v1/domains/availability

https://api.vee3.io/v1/domains/availability

5 tokens

Check whether up to ten domain names can be registered through Vee3 (Namecheap-backed).

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.check_availability

Parameters1 field

domainsarrayRequired

Domain names to check (maximum 10).

min 1, max 10

Response1 field

{domain}boolean

For each requested domain, true if the name can be registered through Vee3; false if it is not available for purchase.

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

Example request

Python

import requests

url = "https://api.vee3.io/v1/domains/availability"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "domains": ["example.org","foo.com","somefoobardomain.io"]
}

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

Example responses1 example

200Availability map for the sample domains request.

sample_availability.json

{
  "example.org": false,
  "foo.com": false,
  "somefoobardomain.io": true
}

GET/v1/domains/whois

https://api.vee3.io/v1/domains/whois

4 tokens

Look up WHOIS registration data for a domain.

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.whois

Parameters2 fields

domainstringRequired

Domain name to look up (for example example.com).

include_registrarbooleanOptional

When true, query registry and registrar WHOIS servers for more complete data. When false (default), query the registry server only.

Response11 fields

{whois_server}object

10 fields

Parsed WHOIS fields returned by one WHOIS server.

Domain Namestring

Registered domain name.

Registrarstring

Sponsoring registrar name.

Created Datestring

Domain creation date.

Expiry Datestring

Domain expiration date.

Name Serverarrayitems

1 field

Authoritative name servers.

name_serverstring

Single name server host name.

Domain Statusarrayitems

1 field

EPP status values.

statusstring

Single domain status value.

textarrayitems

1 field

Raw WHOIS text lines from the server.

linestring

Single text line.

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

Example request

Python

import requests

url = "https://api.vee3.io/v1/domains/whois"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "domain": "rapidapi.com",
    "include_registrar": False
}

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

Example responses1 example

200Registry-only WHOIS response for rapidapi.com.

rapidapi_registry_only.json

{
  "whois.verisign-grs.com": {
    "Domain Name": "RAPIDAPI.COM",
    "Registrar": "MarkMonitor Inc.",
    "Created Date": "2014-09-02T18:49:14Z",
    "Expiry Date": "2025-09-02T18:49:14Z",
    "Name Server": [
      "GINA.NS.CLOUDFLARE.COM",
      "JIM.NS.CLOUDFLARE.COM"
    ]
  }
}

GET/v1/domains/lookup

https://api.vee3.io/v1/domains/lookup

5 tokens

Retrieve normalized domain details including availability, status, dates, registrar, contacts, and nameservers.

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.lookup

Parameters1 field

domainstringRequired

Domain name to look up (for example example.com).

Response28 fields

domainstring

Looked-up domain name.

keywordstring

Second-level domain label without the TLD.

tldstring

Top-level domain suffix.

availabilitystring

Availability state (for example registered or available).

statusstring[]

Normalized EPP status codes.

nameserversstring[]

Authoritative nameserver host names.

datesobject

3 fields

Registration lifecycle dates.

createdstring

Domain creation timestamp.

updatedstring

Last update timestamp.

expirystring

Expiration timestamp.

registrarobject

2 fields

Registrar summary data.

namestring

Registrar name.

ianaIdinteger

Registrar IANA identifier.

contactsobject

13 fields

Registrant, admin, tech, and billing contact records.

registrantobject

3 fields

Registrant contact details.

namestring

Contact name.

emailstring

Contact email address.

organizationstring

Contact organization.

adminobject

2 fields

Administrative contact details.

namestring

Contact name.

emailstring

Contact email address.

techobject

2 fields

Technical contact details.

namestring

Contact name.

emailstring

Contact email address.

billingobject

2 fields

Billing contact details.

namestring

Contact name.

emailstring

Contact email address.

sourcestring

Primary data source used for the normalized response.

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

Example request

Python

import requests

url = "https://api.vee3.io/v1/domains/lookup"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "domain": "example.com"
}

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

Example responses1 example

200Sample normalized lookup response.

example_com_lookup.json

{
  "domain": "example.com",
  "keyword": "example",
  "tld": "com",
  "availability": "registered",
  "status": [
    "clientDeleteProhibited",
    "clientTransferProhibited",
    "clientUpdateProhibited"
  ],
  "nameservers": [
    "ara.ns.cloudflare.com",
    "jay.ns.cloudflare.com"
  ],
  "dates": {
    "created": "2004-10-08T13:53:42.000Z",
    "updated": "2023-03-19T11:04:50.000Z",
    "expiry": "2032-10-08T13:53:42.000Z"
  },
  "registrar": {
    "ianaId": 1910,
    "url": null,
    "name": "Cloudflare, Inc.",
    "email": "registrar-admin@cloudflare.com",
    "whois": "whois.cloudflare.com"
  },
  "source": "rdap"
}

GET/v1/domains/rdap

https://api.vee3.io/v1/domains/rdap

3 tokens

Fetch raw RDAP registration data for a domain.

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.rdap

Parameters1 field

domainstringRequired

Domain name to look up (for example example.com).

max length 253

Response12 fields

objectClassNamestring

RDAP object class (for example domain).

ldhNamestring

Domain name in LDH form.

statusstring[]

EPP status codes for the domain.

entitiesarrayitems

1 field

Registrar, registrant, and related RDAP entities.

objectClassNamestring

RDAP entity object class.

eventsarrayitems

2 fields

Registration, expiration, and last-changed timestamps.

eventActionstring

Event type (for example registration or expiration).

eventDatestring

ISO 8601 event timestamp.

nameserversarrayitems

1 field

Authoritative nameservers for the domain.

ldhNamestring

Nameserver host name.

secureDNSobject

1 field

DNSSEC delegation and DS record data.

delegationSignedboolean

Whether the domain is DNSSEC delegation-signed.

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

Example request

Python

import requests

url = "https://api.vee3.io/v1/domains/rdap"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "domain": "example.com"
}

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

Example responses1 example

200Sample RDAP payload for example.com.

example_com_rdap.json

{
  "objectClassName": "domain",
  "handle": "2336799_DOMAIN_COM-VRSN",
  "ldhName": "EXAMPLE.COM",
  "status": [
    "client delete prohibited",
    "client transfer prohibited",
    "client update prohibited"
  ],
  "events": [
    {
      "eventAction": "registration",
      "eventDate": "1995-08-14T04:00:00Z"
    },
    {
      "eventAction": "expiration",
      "eventDate": "2025-08-13T04:00:00Z"
    }
  ],
  "nameservers": [
    {
      "objectClassName": "nameserver",
      "ldhName": "A.IANA-SERVERS.NET"
    },
    {
      "objectClassName": "nameserver",
      "ldhName": "B.IANA-SERVERS.NET"
    }
  ]
}

GET/v1/domains/tlds

https://api.vee3.io/v1/domains/tlds

2 tokens

Search and paginate top-level domains with registry metadata.

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.list_tlds

Parameters5 fields

searchstringOptional

Return TLDs whose suffix contains this substring.

max length 63

availabilitystringOptional

Filter by registration phase: general-availability (normal public registration) or sunrise (early trademark-holder period).

tld_typestringOptional

Filter by TLD category: country-code, generic, generic-restricted, infrastructure, or sponsored.

limitintegerOptional

Maximum number of TLDs to return. Defaults to 100 when omitted.

min 1

pageintegerOptional

Page number for paginated results.

min 1

Response12 fields

tldsarrayitems

11 fields

Matching top-level domain records.

tldstring

TLD suffix without a leading dot (for example com).

typestring

TLD category (for example country-code or generic). Null when the upstream registry has not classified the TLD.

levelinteger

TLD level (1 for standard TLDs).

availabilitystring

Registration phase for the TLD. Null on unfiltered list results when the upstream registry has not published phase metadata.

whois_serverstring

Authoritative WHOIS server host name.

domains_countinteger

Approximate registered domain count when reported by the registry.

organizationobject

2 fields

Registry operator contact details.

organisationstring

Registry operator name.

addressstring

Registry operator postal address.

createdstring

TLD delegation created timestamp.

changedstring

TLD record last changed timestamp.

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

Example request

Python

import requests

url = "https://api.vee3.io/v1/domains/tlds"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "search": "a",
    "tld_type": "country-code",
    "limit": 8,
    "page": 1
}

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

Example responses1 example

200Sample TLD records filtered by search=a.

country_code_tlds_starting_with_a.json

[
  {
    "tld": "ac",
    "type": "country-code",
    "level": 1,
    "availability": "general-availability",
    "whois_server": "whois.nic.ac",
    "domains_count": null,
    "organization": {
      "address": "c/o Sure (Ascension Island)\nGeorgetown ASCN 1ZZ\nAscension Island",
      "organisation": "Internet Computer Bureau Limited"
    },
    "created": "1997-12-19T00:00:00.000Z",
    "changed": "2023-03-07T00:00:00.000Z"
  }
]

GET/v1/domains/tlds/{tld}

https://api.vee3.io/v1/domains/tlds/{tld}

1 tokens

Retrieve registry metadata and contacts for a top-level domain.

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.tld_details

Parameters1 field

tldstringRequired

TLD suffix to look up without a leading dot (for example io).

max length 63

Response22 fields

tldstring

TLD suffix without a leading dot.

statusstring

Delegation status (for example ACTIVE).

typestring

TLD category (for example country-code or generic).

levelinteger

TLD level (1 for standard TLDs).

availabilitystring

Registration phase for the TLD.

whois_serverstring

Authoritative WHOIS server host name.

rdap_serverstring

Authoritative RDAP server URL.

registry_urlstring

Registry web site URL.

domains_countinteger

Approximate registered domain count when reported by the registry.

createdstring

TLD delegation created timestamp.

changedstring

TLD record last changed timestamp.

contactsarrayitems

6 fields

Registry contact records.

namestring

Contact name.

phonestring

Contact phone number.

e-mailstring

Contact email address.

addressstring

Contact postal address.

contactstring

Contact role (for example administrative or technical).

organisationstring

Contact organization name.

organizationobject

2 fields

Registry operator contact details.

organisationstring

Registry operator name.

addressstring

Registry operator postal address.

remarksstring

Additional registry notes or links.

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

Example request

Python

import requests

url = "https://api.vee3.io/v1/domains/tlds/{tld}"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "tld": "ai"
}

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

Example responses1 example

200Sample registry metadata for .ai.

ai_registry_details.json

{
  "tld": "ai",
  "status": "ACTIVE",
  "type": "country-code",
  "level": 1,
  "availability": "general-availability",
  "whois_server": "whois.nic.ai",
  "rdap_server": "https://rdap.identitydigital.services/rdap/",
  "registry_url": "https://nic.ai",
  "domains_count": 1000000,
  "created": "1995-02-16T00:00:00.000Z",
  "changed": "2025-02-11T00:00:00.000Z",
  "contacts": [
    {
      "name": "Telecommunications Officer",
      "phone": "+1 264 497 5233",
      "e-mail": "telecommunications.office@gov.ai",
      "address": "Coronation Avenue, PO Box 60\nThe Valley AI2640\nAnguilla",
      "contact": "administrative",
      "organisation": "Government of Anguilla, Ministry of Infrastructure, Communications and Utilities"
    }
  ],
  "organization": {
    "address": "Coronation Avenue, PO Box 60\nThe Valley AI2640\nAnguilla",
    "organisation": "Government of Anguilla"
  },
  "remarks": "Registration information: https://nic.ai"
}

GET/v1/domains/managed

https://api.vee3.io/v1/domains/managed

2 tokens

List domains registered and 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.list_managed

Parameters2 fields

limitintegerOptional

Maximum number of domains to return.

Default: 50 · min 1, max 100

pageintegerOptional

Page number for paginated results.

Default: 1 · min 1

Response12 fields

domainsarrayitems

7 fields

Managed domains for this Vee3 account.

domainstring

Managed domain name.

statusstring

Current domain status in Vee3 inventory.

created_atstring

When the domain was registered through Vee3.

expires_atstring

Domain expiration timestamp.

is_lockedboolean

Whether registrar transfer lock is enabled.

privacy_enabledboolean

Whether WhoisGuard privacy protection is enabled.

years_registeredinteger

Registration term in years at purchase.

pagingobject

3 fields

Pagination metadata for the result set.

total_itemsinteger

Total managed domains matching the query.

current_pageinteger

Current page number.

page_sizeinteger

Number of domains returned per page.

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

Example request

Python

import requests

url = "https://api.vee3.io/v1/domains/managed"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "limit": 50,
    "page": 1
}

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

Example responses1 example

200Sample managed domain list response.

managed_domains_page.json

{
  "domains": [
    {
      "domain": "my-new-site.com",
      "status": "active",
      "created_at": "2026-07-31T12:00:00.000Z",
      "expires_at": "2027-07-31T00:00:00.000Z",
      "is_locked": true,
      "privacy_enabled": true,
      "years_registered": 1
    }
  ],
  "paging": {
    "total_items": 1,
    "current_page": 1,
    "page_size": 50
  }
}

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
    }
  ]
}

GET/v1/domains/managed/{domain}

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

3 tokens

Retrieve details for one 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_managed

Parameters1 field

domainstringRequired

Managed domain name to look up (for example example.com).

Response13 fields

domainstring

Managed domain name.

statusstring

Current domain status in Vee3 inventory.

namecheap_domain_idstring

Namecheap domain identifier for the managed domain.

created_atstring

When the domain was registered through Vee3.

expires_atstring

Domain expiration timestamp.

is_lockedboolean

Whether registrar transfer lock is enabled.

is_premiumboolean

Whether the domain was registered as a premium name.

privacy_enabledboolean

Whether WhoisGuard privacy protection is enabled.

privacy_expired_atstring

When privacy protection expired, if applicable.

dns_provider_typestring

DNS provider type configured for the domain.

is_ownerboolean

Whether this Vee3 account is the domain owner.

years_registeredinteger

Registration term in years at purchase.

token_cost_at_registrationinteger

Tokens charged when the domain was registered.

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}"
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 domain detail response.

managed_domain_details.json

{
  "domain": "my-new-site.com",
  "status": "active",
  "namecheap_domain_id": "12345678",
  "created_at": "2026-07-31T12:00:00.000Z",
  "expires_at": "2027-07-31T00:00:00.000Z",
  "is_locked": true,
  "is_premium": false,
  "privacy_enabled": true,
  "privacy_expired_at": null,
  "dns_provider_type": "namecheap",
  "is_owner": true,
  "years_registered": 1,
  "token_cost_at_registration": 1500
}

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

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

5 tokens

Add one Namecheap DNS host record 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.add_dns_host

Parameters6 fields

domainstringRequired

Managed domain name (for example example.com).

host_namestringRequired

Host label to create, for example @, www, or mail.

record_typestringRequired

DNS record type. Supported values: A, AAAA, ALIAS, CAA, CNAME, MX, MXE, NS, TXT, URL, URL301, FRAME.

addressstringRequired

Record value (IP, hostname, URL, or TXT content depending on type).

ttlintegerOptional

TTL in seconds (60 to 60000). Defaults to 1800.

Default: 1800 · min 60, max 60000

mx_prefintegerOptional

MX preference. Required when record_type is MX or MXE.

min 0, max 65535

Response9 fields

domainstring

Managed domain name.

is_using_namecheap_dnsboolean

Whether the domain currently uses Namecheap DNS.

hostsarrayitems

6 fields

Full DNS host list after the addition.

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, dns_not_using_namecheap

Example request

Python

import requests

url = "https://api.vee3.io/v1/domains/managed/{domain}/dns-hosts"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "domain": "my-new-site.com",
    "host_name": "www",
    "record_type": "A",
    "address": "203.0.113.10",
    "ttl": 1800
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Host list after adding one record.

hosts_after_add.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": "125",
      "host_name": "www",
      "record_type": "A",
      "address": "203.0.113.10",
      "mx_pref": null,
      "ttl": 1800
    }
  ]
}

GET/v1/domains/registration-quote

https://api.vee3.io/v1/domains/registration-quote

5 tokens

Get the token cost to register a domain through Vee3 before purchasing. Includes a 200-token registration fee plus the domain price. Token cost depends on the account billing plan.

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.registration_quote

Parameters2 fields

domainstringRequired

Domain name to quote (for example example.com).

yearsintegerOptional

Registration term in years.

Default: 1 · min 1, max 10

Response6 fields

domainstring

Quoted domain name.

yearsinteger

Registration term in years.

availableboolean

Whether the domain can be registered through Vee3.

is_premiumboolean

Whether the domain is priced as a premium name.

token_costinteger

Token cost to register this domain for the quoted term on the account billing plan (200 service tokens plus the domain price).

unavailable_reasonstring

Reason the domain cannot be registered, when available is false.

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

Example request

Python

import requests

url = "https://api.vee3.io/v1/domains/registration-quote"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "domain": "my-new-site.com",
    "years": 1
}

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

Example responses1 example

200Sample quote for an available standard domain.

available_quote.json

{
  "domain": "my-new-site.com",
  "years": 1,
  "available": true,
  "is_premium": false,
  "token_cost": 31832,
  "unavailable_reason": null
}

DELETE/v1/domains/managed/{domain}/dns-hosts/{host_id}

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

5 tokens

Remove one Namecheap DNS host record from 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.remove_dns_host

Parameters2 fields

domainstringRequired

Managed domain name (for example example.com).

host_idstringRequired

Host record id from domains.get_dns_hosts.

Response9 fields

domainstring

Managed domain name.

is_using_namecheap_dnsboolean

Whether the domain currently uses Namecheap DNS.

hostsarrayitems

6 fields

Full DNS host list after the removal.

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, dns_host_not_found, dns_not_using_namecheap

Example request

Python

import requests

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

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Host list after removing one record.

hosts_after_remove.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
    }
  ]
}

GET/v1/domains/renewal-quote

https://api.vee3.io/v1/domains/renewal-quote

5 tokens

Get the token cost to renew a managed domain through Vee3 before purchasing. Includes a 100-token renewal fee plus the domain price. Token cost depends on the account billing plan.

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.renewal_quote

Parameters2 fields

domainstringRequired

Managed domain name to quote for renewal (for example example.com).

yearsintegerOptional

Renewal term in years. Premium domains support 1 year only.

Default: 1 · min 1, max 10

Response6 fields

domainstring

Quoted domain name.

yearsinteger

Renewal term in years.

availableboolean

Whether the domain can be renewed through Vee3 for the quoted term.

is_premiumboolean

Whether the domain is priced as a premium name.

token_costinteger

Token cost to renew this domain for the quoted term on the account billing plan (100 service tokens plus the domain price).

unavailable_reasonstring

Reason the domain cannot be renewed, when available is false.

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/renewal-quote"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "domain": "my-managed-site.com",
    "years": 1
}

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

Example responses1 example

200Sample quote for a renewable standard domain.

available_renewal_quote.json

{
  "domain": "my-managed-site.com",
  "years": 1,
  "available": true,
  "is_premium": false,
  "token_cost": 31732,
  "unavailable_reason": null
}

POST/v1/domains/renew

https://api.vee3.io/v1/domains/renew

100 tokens

Renew a managed domain through Vee3 using a fresh renewal quote.

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.renew

Parameters3 fields

domainstringRequired

Managed domain name to renew (for example example.com).

yearsintegerOptional

Renewal term in years. Premium domains support 1 year only.

Default: 1 · min 1, max 10

expected_token_costintegerRequired

Token cost from a fresh domains.renewal_quote response. Required to prevent surprise charges.

Response7 fields

domainstring

Renewed domain name.

renewedboolean

Whether renewal completed successfully.

yearsinteger

Renewal term in years.

token_costinteger

Tokens charged for this renewal (100 service tokens plus the domain renewal price in tokens).

namecheap_domain_idstring

Namecheap domain identifier for the managed domain.

order_idstring

Namecheap order identifier for the renewal purchase.

expires_atstring

Updated domain expiration timestamp when known.

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

Example request

Python

import requests

url = "https://api.vee3.io/v1/domains/renew"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "domain": "my-managed-site.com",
    "years": 1,
    "expected_token_cost": 31732
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample successful domain renewal response.

successful_renewal.json

{
  "domain": "my-managed-site.com",
  "renewed": true,
  "years": 1,
  "token_cost": 31732,
  "namecheap_domain_id": "12345678",
  "order_id": "987654321",
  "expires_at": "2028-07-31T00:00:00.000Z"
}

POST/v1/domains/register

https://api.vee3.io/v1/domains/register

200 tokens

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.register

Parameters5 fields

domainstringRequired

Domain name to register (for example example.com).

yearsintegerOptional

Registration term in years.

Default: 1 · min 1, max 10

expected_token_costintegerRequired

Token cost from a fresh domains.registration_quote response. Required to prevent surprise charges.

enable_privacybooleanOptional

Whether to enable free WhoisGuard privacy protection when available.

Default: true

contactobjectRequired

Registrant contact used for Registrant, Admin, Tech, and AuxBilling roles. Object with first_name, last_name, address1, city, state_province, postal_code, country (two-letter code), phone (format +NNN.NNNNNNNNNN), and email_address (a real inbox the registrant can access; the registrar may send a verification email that must be completed). Optional fields: address2 and organization_name.

Response8 fields

domainstring

Registered domain name.

registeredboolean

Whether registration completed successfully.

yearsinteger

Registration term in years.

token_costinteger

Tokens charged for this registration (200 service tokens plus the domain price in tokens).

namecheap_domain_idstring

Namecheap domain identifier for the managed domain.

order_idstring

Namecheap order identifier for the registration purchase.

expires_atstring

Domain expiration timestamp when known.

privacy_enabledboolean

Whether WhoisGuard privacy protection is enabled.

Example request

Python

import requests

url = "https://api.vee3.io/v1/domains/register"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "domain": "my-new-site.com",
    "years": 1,
    "expected_token_cost": 31832,
    "enable_privacy": True,
    "contact": {"first_name":"Ada","last_name":"Lovelace","address1":"123 Example Street","city":"London","state_province":"London","postal_code":"SW1A 1AA","country":"GB","phone":"+44.2079460958","email_address":"ada@example.com"}
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample successful domain registration response.

successful_registration.json

{
  "domain": "my-new-site.com",
  "registered": true,
  "years": 1,
  "token_cost": 31832,
  "namecheap_domain_id": "12345678",
  "order_id": "987654321",
  "expires_at": "2027-07-31T00:00:00.000Z",
  "privacy_enabled": true
}