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

get_domain_lookup

Parameters1 field

domainstringRequired

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

Response30 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).

statusarrayitems

1 field

Normalized EPP status codes.

statusstring

Single domain status value.

nameserversarrayitems

1 field

Authoritative nameserver host names.

nameserverstring

Single nameserver host name.

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