WHOIS lookup
Look up a domain's registration details: registrar, registration and expiry dates, and authoritative nameservers.
This is a synchronous GET — the response is returned directly.
Endpoint
GET
/v1/info/whois?q={domain}- Base URL —
https://api-prod.idcd.com/v1 - Auth —
Authorization: Bearer sk_live_...
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
q | string | required | — | Domain to look up (query string). |
Response
| Field | Type | Description |
|---|---|---|
domain | string | The looked-up domain. |
registrar | string | Registrar name. |
creation_date | string | Registration date. |
expiry_date | string | Expiry date. |
name_servers | string[] | Authoritative nameservers. |
note | string | Present when the lookup partially failed or the TLD is unsupported. |
No status / raw fields
Earlier docs listed status and raw fields — these do
not exist in the response. Date fields are creation_date /
expiry_date and nameservers are name_servers.
Example
curl -s "https://api-prod.idcd.com/v1/info/whois?q=example.com" \
-H "Authorization: Bearer sk_live_xxx"
# => {"data":{"domain":"example.com","registrar":"...","creation_date":"1995-08-14",
# "expiry_date":"2026-08-13","name_servers":["a.iana-servers.net"]}}
WHOIS online tool
Look up a domain in the browser — no API key required.