Domain WHOIS Lookup — retrieve registration records

Domain WHOIS Lookup API

What it does

Domain WHOIS Lookup lets you retrieve a domain’s WHOIS record by sending a domain query parameter. It returns the domain name plus the registration details exposed by the lookup service.

Use it when you need to check who owns a domain, which registrar manages it, and whether it has expiration or creation dates on record. The response can include org, country, registrar, expiry_date, creation_date, emails, status, and name_servers, along with the requested domain.

That makes it useful for domain due diligence, support workflows, and basic security checks. For example, you can validate a partner’s domain registration details before onboarding, or look up a site’s registrar and expiry date when tracking renewal risk.

The response is straightforward and machine-friendly, so you can store the record, compare it against internal records, or surface the key fields in your own admin tools.

What you'll get back

Returns a JSON object with the WHOIS fields declared in the schema: org, domain, emails, status, country, registrar, expiry_date, name_servers, and creation_date. org, country, registrar, expiry_date, and creation_date are strings or null; domain is a string; the remaining fields are untyped in the schema.

{
  "org": "Example Inc.",
  "domain": "example.com",
  "emails": ["[email protected]"],
  "status": ["clientTransferProhibited"],
  "country": "US",
  "registrar": "Example Registrar, Inc.",
  "expiry_date": "2026-01-01T00:00:00Z",
  "name_servers": ["ns1.example.com", "ns2.example.com"],
  "creation_date": "1995-08-13T00:00:00Z"
}

About this endpoint

What it does

Retrieves the full WHOIS record for a domain and returns it as a JSON object with the domain-level registration details captured in the output schema.

Query Parameter(s)

Attribute	Type	Mandatory	Description
domain	String	Yes	The domain name to look up.

Response

Returns a JSON object with these top-level fields: org, domain, emails, status, country, registrar, expiry_date, name_servers, and creation_date. The schema does not define a more specific structure for emails, status, or name_servers, so those fields should be treated according to the actual API response.

Parameter	Type	Mandatory	Description
org	String	No	The organization associated with the WHOIS record. Nullable.
domain	String	No	The domain name.
emails	Object	No	WHOIS email data. The schema does not define its internal shape.
status	Object	No	WHOIS status data. The schema does not define its internal shape.
country	String	No	The country associated with the WHOIS record. Nullable.
registrar	String	No	The registrar name. Nullable.
expiry_date	String	No	The domain expiry date. Nullable.
name_servers	Object	No	WHOIS name server data. The schema does not define its internal shape.
creation_date	String	No	The domain creation date. Nullable.

Query parameters

Name

Type

Description

domainREQUIRED

string

—

Domain WHOIS Lookup API

What it does

Quickstart

What you'll get back

About this endpoint

What it does

Query Parameter(s)

Response

Query parameters

Errors any endpoint can return