Other
/api/v1/abuse-contact-lookupPacketFlo Abuse Contact Lookup API
Find a domain's registrar abuse contact, straight from WHOIS.
| Parameter | Type | Required | Description |
|---|---|---|---|
domain | string | Yes | Domain to look up. |
Example request
curl "https://packetflo.io/api/v1/abuse-contact-lookup?domain=example.com&api_key=YOUR_API_KEY"
Example response
{ "ok": true, "data": { "domain": "example.com", "matchedDomain": null, "registrar": "Example Registrar, Inc.", "email": "[email protected]", "phone": "+1.5555550123", "found": true }, "meta": { "tool": "abuse-contact-lookup", "version": "v1" } }
Reading the result
found means an abuse email or phone number was returned. A false result can also reflect unavailable registration services.
Response fields
| Field | What it tells you |
|---|---|
domain / matchedDomain | Requested domain and parent registration match when applicable. |
registrar / email / phone | Published registrar/contact information. Unavailable values are null. |
found | True if an email or phone contact was found. |
Scope and limits
Uses WHOIS with RDAP fallback and can look up a parent domain for subdomains. Published contacts are registration or network abuse contacts, not necessarily the website owner's personal details. The lookup does not send an abuse report.
Authentication and errors
Send your key in the x-api-key header, or the supported api_key query parameter. Each request uses 2 credits 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. |