WHOIS and RDAP

API key v1

Registrar, dates, status and nameservers for a domain.

Looks the domain up over RDAP, the structured successor to WHOIS, using the IANA bootstrap to find the right registry, and falls back to the classic port-43 WHOIS service for registries without RDAP. Returns the registrar, creation, update and expiry dates, EPP status codes, nameservers and DNSSEC flag.

GET https://api.zactonz.com/domain/whois/

Parameters

Name	Type	Description
`domain`required	string	Domain name. A host name or URL is reduced to its registrable domain.
`raw`	boolean	`1` includes the raw WHOIS text when the fallback service was used. Default

Send parameters in the query string.

Response

Field	Type	Description
`status`	integer	`200` on success.
`data`	object	The result.
`data.domain`	string	Registrable domain.
`data.source`	string	`rdap` or `whois`.
`data.registry`	string	RDAP base URL or WHOIS server used.
`data.registrar`	string	Registrar name.
`data.abuse_contact`	string	Registrar abuse email when published.
`data.status`	array of string	EPP status codes.
`data.created`	string	Registration date.
`data.updated`	string	Last change.
`data.expires`	string	Expiry date.
`data.nameservers`	array of string	Delegated nameservers.
`data.dnssec`	boolean	Whether the delegation is signed.
`data.raw`	string	Raw WHOIS text, only with `raw=1` on the fallback path.

Status codes

The outcome is reported in the JSON status field. See Errors & status codes for the general rules.

`400`	Bad request	`domain` is missing or not a domain name.
`404`	Not found	The registry has no record for this domain.
`422`	No service	No RDAP or WHOIS service is known for that top-level domain, or it did not answer.
`503`	Registry busy	The registry is rate limiting; retry shortly.
`401`	Unauthorized	The Authorization header is missing or the key is not recognised.
`403`	Forbidden	The key is not licensed for this product.
`429`	Too many requests	The per-minute rate or the plan quota is exhausted. Retry after the seconds given in `Retry-After`.

Notes

Subdomains are reduced to the registrable domain. Answers are cached for an hour. Registries rate-limit lookups; a 503 means the registry asked us to slow down.