Where to send an abuse report, for every address.
The contact that takes abuse reports for each address range, resolved from the registries' records and operators' RWHOIS servers, with the email, phone and postal address, and the block the contact was taken from.
In the lookup API: abuse.email on every plan, and the rest of abuse on a paid plan.
Look up one address free with the abuse contact lookup.
Real rows, with what each column means.
See documentation →The schema and metadata are in the docs. It is published as CSVGZ and MMDB.
| start_ip | end_ip | network | name | phone | country | address | |
|---|---|---|---|---|---|---|---|
| 1.1.1.0 | 1.1.1.255 | 1.1.1.0-1.1.1.255 | ABUSE APNICRANDNETAU | helpdesk@apnic.net | AU | PO Box 3646, South Brisbane, QLD 4101, Australia | |
| 8.8.8.0 | 8.8.8.255 | 8.8.8.0-8.8.8.255 | Abuse | network-abuse@google.com | +1-650-253-0000 | US | 1600 Amphitheatre Parkway, Mountain View, CA, 94043 |
| 12.4.166.88 | 12.4.166.119 | 12.0.0.0-12.255.255.255 | abuse | abuse@att.net | +1-919-319-8167 | US | 2701 W 15th ST, Plano, TX, 75075 |
| 88.198.0.0 | 88.198.71.199 | 88.198.0.0-88.198.255.255 | Hetzner Online GmbH - Contact Role | abuse@hetzner.com | +49 9831 505-3 | DE | Hetzner Online GmbH, Industriestrasse 25, D-91710 Gunzenhausen, Germany |
| 2a01:4f8:: | 2a01:4f8:171:f7ff:ffff:ffff:ffff:ffff | 2a01:4f8::/29 | Hetzner Online GmbH - Contact Role | abuse@hetzner.com | +49 9831 505-3 | DE | Hetzner Online GmbH, Industriestrasse 25, D-91710 Gunzenhausen, Germany |
Download it from your code in one call.
Database API reference →Every official client fetches the current IP Abuse Contact build to disk, as a link for your own runner or into memory, and checks it against its published checksums.
download()downloadUrl()downloadBytes()metadata()checksums()import osfrom internetdata import InternetDataclient = InternetData(os.environ["INTERNETDATA_API_KEY"])# what is in today's build, without moving the filemeta = client.database.metadata("ip_abuse_contact_v1")client.database.download("ip_abuse_contact_v1", "mmdb", "./ip_abuse_contact_v1.mmdb")sums = client.database.checksums("ip_abuse_contact_v1", "mmdb")print(meta.updated, meta.entries, sums["sha256"])
Put it to work in your own systems.
Teams join IP Abuse Contact against traffic they already log, inside their own infrastructure, and never send an address anywhere to get an answer.
Abuse reporting
Send each report to the mailbox that handles abuse for that range, not to the registry that allocated it.
Reporting in bulk
Route what your own detection finds to the right contacts by address, without a lookup per report.
Call the API in your language, with an official client.
All SDKs on GitHub →Thirteen official clients, one for each language you ship in and one for the browser, plus middleware for fifteen web frameworks. Each answers private addresses without a request, caches what it looks up and splits big batches for you.
Common questions
Where does a contact come from?
From the registries' records and operators' RWHOIS servers. network names the block whose record supplied it.
Why does name hold a company on some rows?
When the record names no abuse contact, name falls back to the organization holding the block.
Why is phone or address empty?
Many records publish only an email. Phone and address are there when the record has them.
What do validated and unvalidated_since mean?
validated is 1 when ARIN reports that the contact answered its yearly validation, and unvalidated_since dates when it stopped answering. The other registries publish no such state, so both are empty on their records.
Why not report to the registry?
A registry only allocates the space. The contact here is the one that handles abuse for that range.
How often is it rebuilt?
Daily. The metadata call answers when the current build landed and how many rows it holds, before you fetch it.
Which formats does a build ship in?
Gzipped CSV and MMDB, both cut from the same build. The MMDB opens in any MaxMind DB reader.
How do we get it?
Under a Standard or Redistribution license, quoted per database. Get a quote names IP Abuse Contact to us, and Request evaluation puts the full current build in your hands to test first. Download sample gets you rows from it now.
Is there a lookup API?
Yes. An address lookup answers abuse.email on every plan, free included, and the rest of abuse on a paid plan.
What if a row looks wrong?
Send it to us and we'll tell you what we hold on it and when it was last seen. Corrections land in the next build.
Unlimited lookups, no sign-up.
Paste it into a terminal. Any address answers with its country, network, company and hostname, with no key and no daily or monthly cap. ASes and domains answer too.
{"ip": "8.8.8.8","is_tor": false,"is_anycast": true,"is_dns_resolver": true,"location": {"country": "US", ...},"asn": { "asn": 15169, ... },"hostname": "dns.google"}
All of the data on a paid plan.
A free API key answers every field for its first 100 lookups each day, with no card.