Other
GET
/api/v1/whoisPacketFlo WHOIS API
Cost: 1 credit per request
Registrar, registration dates, and name servers.
| Parameter | Type | Required | Description |
|---|---|---|---|
domain | string | Yes | Domain to look up. |
Example request
curl "https://packetflo.io/api/v1/whois?domain=example.com&api_key=YOUR_API_KEY"
Example response
{ "ok": true, "data": { "domain": "example.com", "notFound": false, "source": "WHOIS", "matchedDomain": null, "registrar": "Example Registrar, Inc.", "creationDate": "2009-02-17T22:07:54Z", "expiryDate": "2033-02-17T22:07:54Z", "updatedDate": "2024-01-09T16:45:28Z", "nameServers": ["ns1.example.com", "ns2.example.com"], "daysUntilExpiry": 2353, "message": null, "raw": " Domain Name: EXAMPLE.COM\n Registrar: Example Registrar, Inc.\n ..." }, "meta": { "tool": "whois", "version": "v1" } }
Reading the result
Check source and notFound before relying on registration details. A DNS fallback contains less information than WHOIS or RDAP.
Response fields
| Field | What it tells you |
|---|---|
source / matchedDomain | WHOIS, RDAP or DNS fallback, plus the matched parent domain when applicable. |
registrar / nameServers / raw | Registration provider, nameservers and underlying report. |
creationDate / expiryDate / updatedDate | Provider-supplied dates; formats can vary and unavailable values may be n/a. |
daysUntilExpiry / message / notFound | Remaining days when known, explanatory message and missing-result flag. Not-found responses can omit the usual detail fields. |
Scope and limits
Registration services may redact data or limit requests. DNS fallback cannot establish full registration details. notFound is not a guarantee that a domain is available to register.
Authentication and errors
Send your key in the x-api-key header, or the supported api_key query parameter. Each request uses 1 credit from the key's shared 300-credit rolling 24-hour budget. Credits are charged before parameter validation. Successful responses and quota errors include usage headers; GET and OPTIONS support CORS.
| API status | Meaning |
|---|---|
200 | The diagnostic returned a result in data, with ok: true and version information in meta. Read the diagnostic fields to determine the target's condition. |
400 | Invalid or blocked input, or a lookup/check failure that could not be returned as a diagnostic result. Read error for details. |
401 | Missing, invalid or revoked API key. |
429 | The request would exceed the key's available credit budget. |