The Good Guys.
API Reference

Developer Docs

HTTPS. Bearer tokens. JSON in, JSON out. Every endpoint responds under 300ms.

Authentication

All authenticated endpoints require a Bearer token. Get one from your Dashboard → API Keys.

Authorization: Bearer gg_live_YOUR_KEY

Quickstart

curl -X POST https://api.thegoodguys.app/api/validate/phone \
  -H "Authorization: Bearer gg_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"value":"+14155552671"}'

Endpoints

POST/api/validate/phoneHLR + carrier + spam lookup
POST/api/validate/emailSyntax + MX + SMTP + disposable
POST/api/validate/ipGeo + Tor + VPN + proxy risk
POST/api/validate/bulkBatch up to 500 values per request
POST/api/keys/generateCreate a new Bearer key
GET/api/lookupsRecent verification history
GET/api/statsUsage stats by kind