Register domain

← All Domains endpoints · Capability overview

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.

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

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
}