API Reference

Complete API documentation for FraudHawkAI services

📱

Phone Validator API

Production Readyv1.0.0

Validate phone numbers in real-time. Detect fraud, check carrier information, and prevent COD returns.

POST/api/tools/phone-validator

Features

Real-time validationCountry detectionCarrier informationFraud risk scoringDisposable number detection
100/day (Free)
View Docs
🌐

IP Intelligence API

Betav0.9.0

Check IP addresses for VPN, proxy, and fraud indicators. Get location data and risk scores.

POST/api/tools/ip-checker

Features

VPN detectionProxy detectionLocation dataRisk scoringISP information
100/day (Free)
View Docs
🔗

Webhooks API

Coming Soonv0.5.0

Receive real-time notifications for fraud detection, order updates, and system events.

POST/api/webhooks

Features

Fraud alertsOrder status updatesRisk score changesCustom webhook endpointsRetry mechanism
Unlimited
📊

Batch Phone Validator API

Coming Soonv0.5.0

Validate multiple phone numbers in a single request. Perfect for bulk processing.

POST/api/tools/phone-validator/batch

Features

Bulk validationCSV/JSON supportProgress trackingExport resultsError handling
1,000/day (Pro)
🛡️

Fraud Scoring API

Coming Soonv0.3.0

Get comprehensive fraud risk scores based on multiple data points and intelligence.

POST/api/fraud/score

Features

Multi-factor scoringReal-time analysisRisk categoriesRecommended actionsHistorical data
500/day (Enterprise)

API Usage Guidelines

Authentication

All API requests require an API key. Include it in the X-API-Key header.

Rate Limits

Free tier: 100 requests/day. Pro: 1,000/day. Enterprise: 10,000/day. Limits reset at midnight UTC.

Errors

Standard HTTP status codes. 429 = rate limit exceeded. 401 = invalid API key. 500 = server error.

Ready to Integrate?

Get your API key and start building with FraudHawkAI today.