API
Everything needed to talk to the ReportedIP REST API — the full endpoint reference, how authentication and daily quotas work, the threat category list, and how an IP address earns its confidence score.
In this section
API Reference
Every endpoint with parameters, quota cost and examples in cURL, PHP, Python and JavaScript.
Authentication
How to send an API key, which role gets which quota, and what the 401, 403 and 429 responses mean.
Threat Categories
All 58 categories with their severity levels, and how to send them when reporting.
Confidence Score
The scoring formula in full: weighting, reporter diversity, recency, severity, honeypot bonus and time decay.
Changelog
Every API release with new endpoints, quota changes and breaking changes.
Explore more
Last updated: · Maintained by the ReportedIP team
Security Focused
GDPR Compliant
Made in Germany