API Documentation

Integrate SmishGuard threat intelligence into your security tools, SIEMs, and SOC workflows.

Authentication

All API requests require an API key passed via the x-api-key header.

curl -H "x-api-key: sg_your_api_key" \
https://smishguard.app/api/v1/reports

Endpoints

POST

/api/v1/reports

Submit a smishing report programmatically

{ "message_content": "...", "sender_number": "+1234..." }

GET

/api/v1/reports

Query reports with filters (date, threat_level, status)

Params: ?threat_level=critical&limit=50&offset=0

GET

/api/v1/iocs

Get extracted IOCs (domains, IPs, URLs, phones)

Params: ?type=domain&limit=100

GET

/api/v1/stats

Platform statistics (report counts, top threats, trends)

Rate Limits

Default: 60 requests/minute per API key. Contact us for higher limits.

Rate limit headers: X-RateLimit-Remaining