WHOIS Lookup

The Nexus WHOIS Lookup API returns WHOIS registration data for a domain. You can also search across all collected records by registrar, nameserver, TLD, status, or expiry date.

note

If no WHOIS data has been collected for a domain, whois_data will be null.

Domain WHOIS Lookup

Retrieve WHOIS registration data for a single domain. Deducts 1 credit per request.

HTTP Request

GET https://fullhunt.io/api/v1/nexus/whois/lookup

Query Parameters

Parameter	Required	Type	Description
`domain`	Yes	string	Domain name to look up WHOIS data for

Example Request

curl "https://fullhunt.io/api/v1/nexus/whois/lookup?domain=acme.com" \
  -H "X-API-KEY: xxxx-xxxx-xxxx-xxxxxx"

Example Response

{
  "domain": "acme.com",
  "whois_data": {
    "domain": "acme.com",
    "tld": "com",
    "queried_at": "2026-05-03T23:13:23.596Z",
    "rdap": {
      "source": "https://rdap.verisign.com/com/v1/",
      "registrar": "Example Registrar, Inc.",
      "registrant": "",
      "nameservers": ["ns1.acme-dns.com", "ns2.acme-dns.com"],
      "status": [
        "client transfer prohibited",
        "client update prohibited",
        "client delete prohibited"
      ],
      "created_at": "2004-05-19T21:00:30.000Z",
      "updated_at": "2026-03-23T03:38:21.000Z",
      "expires_at": "2027-05-19T21:00:30.000Z",
      "events": [
        {"action": "registration", "date": "2004-05-19T21:00:30.000Z"},
        {"action": "expiration", "date": "2027-05-19T21:00:30.000Z"},
        {"action": "last changed", "date": "2026-03-23T03:38:21.000Z"}
      ],
      "entities": [
        {"handle": "940", "roles": ["registrar"], "name": "Example Registrar, Inc.", "org": "", "email": ""}
      ],
      "raw": null
    },
    "whois": {
      "source": "whois.verisign-grs.com",
      "registrar": "Example Registrar, Inc.",
      "registrant": "",
      "status": ["ok https://icann.org/epp#ok"],
      "nameservers": ["ns1.acme-dns.com", "ns2.acme-dns.com"],
      "created_at": "2004-05-19T21:00:30.000Z",
      "updated_at": "2026-03-23T03:38:21.000Z",
      "expires_at": "2027-05-19T21:00:30.000Z",
      "raw": ""
    },
    "errors": null
  }
}

If no WHOIS data has been collected for the domain:

{
  "domain": "example.com",
  "whois_data": null
}

Response Fields

Field	Type	Description
`domain`	string	The queried domain
`whois_data`	object \| null	WHOIS registration data, or `null` if not collected
`whois_data.domain`	string	The domain name
`whois_data.tld`	string	Top-level domain
`whois_data.queried_at`	string	When FullHunt last fetched this record (ISO 8601)
`whois_data.rdap`	object	RDAP registration data
`whois_data.rdap.registrar`	string	Registrar name (RDAP)
`whois_data.rdap.nameservers`	array	Authoritative nameservers (RDAP)
`whois_data.rdap.status`	array	EPP domain status codes (RDAP)
`whois_data.rdap.created_at`	string	Registration date (ISO 8601)
`whois_data.rdap.updated_at`	string	Last updated date (ISO 8601)
`whois_data.rdap.expires_at`	string	Expiry date (ISO 8601)
`whois_data.rdap.events`	array	Registration lifecycle events
`whois_data.rdap.entities`	array	Registrar and registrant entities
`whois_data.whois`	object \| null	Classic WHOIS data (may be `null` for some TLDs)
`whois_data.whois.registrar`	string	Registrar name (WHOIS)
`whois_data.whois.nameservers`	array	Authoritative nameservers (WHOIS)
`whois_data.whois.status`	array	EPP domain status codes (WHOIS)
`whois_data.whois.created_at`	string	Registration date (ISO 8601)
`whois_data.whois.updated_at`	string	Last updated date (ISO 8601)
`whois_data.whois.expires_at`	string	Expiry date (ISO 8601)
`whois_data.errors`	array \| null	Any errors encountered during lookup

WHOIS Search

Search across all collected WHOIS records. Deducts 1 credit per request.

HTTP Request

GET https://fullhunt.io/api/v1/nexus/whois/search

Query Parameters

Parameter	Required	Type	Description
`registrar`	No	string	Partial or full registrar name (case-insensitive)
`nameserver`	No	string	Partial or full nameserver hostname (case-insensitive)
`tld`	No	string	Top-level domain (e.g. `com`, `io`, `net`)
`status`	No	string	EPP status string to match (e.g. `client transfer prohibited`)
`expires_before`	No	string	Return domains expiring before this date (ISO 8601)
`limit`	No	integer	Max results to return (default `10`, max `10`)

At least one of registrar, nameserver, tld, status, or expires_before is required.

Example — search by registrar

curl "https://fullhunt.io/api/v1/nexus/whois/search?registrar=GoDaddy&tld=com&limit=50" \
  -H "X-API-KEY: xxxx-xxxx-xxxx-xxxxxx"

Example — search by nameserver

curl "https://fullhunt.io/api/v1/nexus/whois/search?nameserver=ns1.acme-dns.com" \
  -H "X-API-KEY: xxxx-xxxx-xxxx-xxxxxx"

Example — find expiring domains

curl "https://fullhunt.io/api/v1/nexus/whois/search?expires_before=2027-01-01T00:00:00.000Z&tld=com" \
  -H "X-API-KEY: xxxx-xxxx-xxxx-xxxxxx"

Example Response

{
  "filters": {
    "registrar": "GoDaddy",
    "nameserver": null,
    "tld": "com",
    "status": null,
    "expires_before": null
  },
  "total_results": 2,
  "results": [
    {
      "domain": "acme.com",
      "whois_data": {
        "domain": "acme.com",
        "tld": "com",
        "queried_at": "2026-05-03T23:13:23.596Z",
        "rdap": {
          "registrar": "GoDaddy.com, LLC",
          "nameservers": ["ns1.acme-dns.com", "ns2.acme-dns.com"],
          "status": ["client transfer prohibited"],
          "created_at": "2004-05-19T21:00:30.000Z",
          "updated_at": "2026-03-23T03:38:21.000Z",
          "expires_at": "2027-05-19T21:00:30.000Z"
        },
        "whois": {
          "registrar": "GoDaddy.com, LLC",
          "nameservers": ["ns1.acme-dns.com", "ns2.acme-dns.com"],
          "status": ["ok https://icann.org/epp#ok"],
          "expires_at": "2027-05-19T21:00:30.000Z"
        },
        "errors": null
      }
    }
  ]
}

Response Fields

Field	Type	Description
`filters`	object	The filters applied to this search
`total_results`	integer	Number of matching records returned
`results`	array	Array of matching domain WHOIS objects
`results[].domain`	string	Domain name
`results[].whois_data`	object \| null	Full WHOIS record (same schema as lookup endpoint)

Credit Usage

Both endpoints deduct 1 credit per successful request.

Use Cases

Domain Intelligence: Enrich domain lookups with registration data
Threat Investigations: Identify registrant details for suspicious domains
Brand Protection: Find all domains sharing a registrar or nameserver
Expiry Monitoring: Surface domains expiring within a time window
Phishing Analysis: Check registration age and infrastructure of suspected phishing domains
Infrastructure Pivoting: Find all domains pointing to the same nameservers

Error Handling

Status Code	Description
200	Success
400	Bad Request — missing or invalid parameters
401	Unauthorized — invalid API key
403	Forbidden — no remaining credits
422	Unprocessable Entity — invalid domain format or missing filters
429	Rate limit exceeded (30 requests/minute)
500	Internal server error

Domain WHOIS Lookup​

WHOIS Search​

Credit Usage​

Use Cases​

Error Handling​

Domain WHOIS Lookup

WHOIS Search

Credit Usage

Use Cases

Error Handling