WHOIS Lookup
Authentication
All API requests require authentication using an API key. You can create an API key in your dashboard.
Include your API key in the Authorization header of your requests:
Authorization: Bearer your_api_key
Credit Usage
Each API call consumes credits from your account. This service costs 2 credits per call.
Endpoints
Retrieve WHOIS information for a specified domain
Example Request
curl -X POST "https://api.goonlinetools.com/api/v1/whois-lookup" \
-H "Authorization: Bearer your_api_key" \
-H "Content-Type: application/json" \
-d '{"domain": "goonlinetools.com"}'Example Response
{
"domain": "goonlinetools.com",
"registrar": "Cloudflare, Inc.",
"registrarUrl": "http://www.cloudflare.com",
"creationDate": "2019-11-20T10:30:03.000Z",
"expirationDate": "2026-11-20T10:30:03.000Z",
"lastUpdated": "2025-02-17T05:38:15.000Z",
"nameservers": [
"ARYA.NS.CLOUDFLARE.COM",
"HANK.NS.CLOUDFLARE.COM"
],
"status": [
"clientTransferProhibited https://icann.org/epp#clientTransferProhibited",
"clientTransferProhibited https://icann.org/epp#clientTransferProhibited"
],
"registrant": {
"organization": "Unknown",
"country": null
},
"timestamp": "2025-04-04T07:59:59.824Z"
}Error Handling
The API uses standard HTTP status codes to indicate the success or failure of a request. Error responses include a JSON object with an error message.
{
"error": "Error message"
}Common Errors
| Status Code | Error Message | Description |
|---|---|---|
| 400 | Missing domain parameter | The domain parameter is required |
| 400 | Invalid domain format | The domain name format is invalid |
| 404 | WHOIS information not found | No WHOIS information could be found for the domain |
| 429 | Too many requests | You've exceeded the rate limit for this API |
Implementation Notes
The WHOIS Lookup API retrieves domain registration information from WHOIS databases. The information returned may vary based on the registrar and the domain's registration status.
For privacy reasons, some registrars may redact personal information from WHOIS records. In these cases, the API will return the available public information.