Domain lookup

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

← All Domains endpoints · Capability overview

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