curl --request POST \
--url https://www.ntanduy.com/api/v1/domain/whois \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"domain": "example.com"
}
'{
"success": true,
"data": {
"domain": "example.com",
"query_domain": "www.example.com",
"registered": true,
"registrar": "Example Registrar, Inc.",
"organization": "Example Organization",
"creation_date": "2020-01-10T00:00:00.000Z",
"updated_date": "2026-01-10T00:00:00.000Z",
"expiration_date": "2027-01-10T00:00:00.000Z",
"status": [
"client transfer prohibited"
],
"dnssec": "unsigned",
"name_servers": [
"ns1.example.net",
"ns2.example.net"
],
"meta": {
"cached": false
}
}
}Lookup domain WHOIS
Check registration status and normalized WHOIS details for a domain.
curl --request POST \
--url https://www.ntanduy.com/api/v1/domain/whois \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"domain": "example.com"
}
'{
"success": true,
"data": {
"domain": "example.com",
"query_domain": "www.example.com",
"registered": true,
"registrar": "Example Registrar, Inc.",
"organization": "Example Organization",
"creation_date": "2020-01-10T00:00:00.000Z",
"updated_date": "2026-01-10T00:00:00.000Z",
"expiration_date": "2027-01-10T00:00:00.000Z",
"status": [
"client transfer prohibited"
],
"dnssec": "unsigned",
"name_servers": [
"ns1.example.net",
"ns2.example.net"
],
"meta": {
"cached": false
}
}
}domain:whois scope.
See Authentication for OAuth support and credential handling.
The response contains normalized public registry data. Optional fields depend on
what the registry provides, and personally identifying WHOIS contact fields are removed.
Set forceRefresh only when you need to attempt a fresh upstream lookup. If the
provider fails and cached data exists, the API may return that data with
meta.stale: true. Normal requests are faster and place less load on providers.
Subscription-backed API keys
Paid self-service keys use shared owner credits and the plan’s per-second and concurrent-job limits. Successful results, including cache hits, consume the configured action cost; errors release the reservation. Video jobs settle at completion. InspectX-ApiKey-Credit-* and X-ApiKey-RateLimit-*.
An optional Idempotency-Key prevents repeated synchronous execution/debits;
repeated operations return 409 rather than replaying a response. Job starts use
requestId instead. See API plans and idempotency
for costs, billing periods, headers, error codes and retry rules.Authorizations
OAuth 2.0 Authorization Code with PKCE, issued by Pirehub's Clerk authorization server. Request only the scopes required by the operation.
Headers
Self-service keys only. Owner-scoped operation identifier; reuse after admission returns 409 without another debit or execution. USAGE_CONCURRENCY_EXCEEDED retains no new reservation: wait and retry with the same identifier and payload. No response replay. Video jobs use requestId instead.
1 - 80^[a-zA-Z0-9_-]+$Body
A domain, subdomain, or HTTP(S) URL. The API strips the URL path and normalizes the hostname before lookup.
1"example.com"
"www.example.com"
"https://www.example.com/about"
Attempt a fresh upstream WHOIS lookup. If the provider fails and cached data exists, the API may return it with meta.stale: true.