Developer Docs

API Documentation

Integrate email and IP risk intelligence in minutes. All endpoints require a Bearer token.

API access is available on Growth and above

Authentication

Include your API key in every request:

curl -X POST https://yourdomain.com/api/v1/email/check \
  -H "Authorization: Bearer fsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"email":"test@example.com"}'

Get your API key from the Dashboard.

Endpoints

POST/api/v1/email/check

Check if an email is valid, disposable, or risky.

Request

{
  "email": "test@mailinator.com"
}

Response

{
  "success": true,
  "email": "test@mailinator.com",
  "valid": true,
  "disposable": true,
  "domain": "mailinator.com",
  "risk_score": 40
}

POST/api/v1/ip/check

Analyze IP address for VPN, proxy, or private network signals.

Request

{
  "ip": "8.8.8.8"
}

Response

{
  "success": true,
  "ip": "8.8.8.8",
  "is_private": false,
  "is_localhost": false,
  "risk_score": 0
}

POST/api/v1/risk/check

Run a combined email + IP risk check with recommendation output.

Request

{
  "email": "spam@mailinator.com",
  "ip": "1.1.1.1"
}

Response

{
  "success": true,
  "risk_score": 70,
  "decision": "BLOCK",
  "reasons": ["Disposable email detected"],
  "ai_reason": "The email is from a disposable domain, indicating potential abuse.",
  "email": "spam@mailinator.com",
  "ip": "1.1.1.1"
}

Pre-send List Audit

POST/api/v1/pre-send/check

Real-time screening before campaigns go out through Gmail, Outlook, HubSpot, or your own sender workflow.

Request (batch up to 1,000)

{
  "emails": ["lead1@company.com", "spam@temp.com", "..."],
  "campaign_id": "spring-outreach-2026"
}

Response

{
  "success": true,
  "summary": { "total": 1000, "allowed": 820, "blocked": 180 },
  "campaign_risk": "LOW",
  "results": [{ "email": "...", "decision": "ALLOW" }]
}

Integration tip: call this endpoint before sending. If decision = BLOCK, skip that recipient.

Google Sheets

The spreadsheet install guide now lives on its own page so non-developers can jump straight into setup.

Open Google Sheets Guide

Error Codes

401 Missing or invalid API key

429 Monthly limit exceeded

400 Invalid request body

Ready to integrate?

Create a free account now, then upgrade to Growth when you need API access.

Create Free Account