Integrate email risk analysis into your own apps
SendGate provides a robust REST API for self-hosted deployments. Automate list hygiene by checking risks in real-time within your own infrastructure.
{
"input": "jane@acme.dev",
"email": "jane@acme.dev",
"domain": "acme.dev",
"verdict": "deliverable",
"score": 95,
"suggestion": null,
"reasons": [
{
"code": "MAILBOX_ACCEPTED",
"severity": "info",
"message": "The mail server accepted this recipient"
}
],
"checks": {
"syntax": { "valid": true, ... },
"roleAccount": false,
"smtp": { "status": "accepted", "catchAll": false, ... },
"domain": { "mail": { "status": "ok", ... }, ... }
}
}Built for developers
Single & batch verification
Real-time checks for signup forms, and batch checks for lists.
Sandbox Environment
Test your integration without DNS or SMTP traffic: deliverable@, undeliverable@, full@ and greylisted@ return fixed results.
Mailbox checks
MX resolution, optional SMTP RCPT verification and catch-all detection.
Behavioral Detection
Identify typos, role-based, and disposable emails.
API Reference
Authentication
SENDGATE_API_KEY environment variable on your own instance. This public demo does not accept external API requests.Pass your configured key in the Authorization header:
Authorization: Bearer YOUR_CONFIGURED_KEY
Verify an Email
/api/v2/verifyRequest Body
{
"email": "jane@acme.dev",
"sandbox": false
}Response
{
"input": "jane@acme.dev",
"email": "jane@acme.dev",
"domain": "acme.dev",
"verdict": "deliverable",
"score": 95,
"suggestion": null,
"reasons": [
{
"code": "MAILBOX_ACCEPTED",
"severity": "info",
"message": "The mail server accepted this recipient"
}
],
"checks": {
"syntax": { "valid": true, ... },
"roleAccount": false,
"smtp": { "status": "accepted", "catchAll": false, ... },
"domain": { "mail": { "status": "ok", ... }, ... }
}
}Verify a Batch
/api/v2/verify/batchUp to MAX_BULK_EMAILS addresses per request. Duplicates are removed; each domain is checked once.
{
"emails": ["a@acme.dev", "b@acme.dev"],
"sandbox": false
}{
"summary": {
"total": 2, "unique": 2,
"duplicates": 0, "invalid": 0,
"verdicts": { "deliverable": 2, "risky": 0,
"undeliverable": 0, "unknown": 0 },
"reasons": { "MAILBOX_ACCEPTED": 2 }
},
"results": [ ... ]
}Verdicts
- deliverable: the mail server accepted the recipient and nothing else is wrong.
- risky: deliverable, but likely to hurt (disposable, catch-all, typo, blocklisted domain, no-reply).
- undeliverable: invalid syntax, missing domain or mail server, or the mailbox does not exist.
- unknown: nothing bad found, but the mailbox could not be confirmed (SMTP verification off, greylisting, provider that accepts everything).
Health Check
/api/healthMonitor instance status, version, and uptime. No authentication required.
Sample Response
{
"status": "healthy",
"version": "0.2.0",
"uptime": 3600.5,
"capabilities": {
"smtp": { "enabled": true, "available": true },
"disposableDomains": 10181,
"api": true,
"maxBulkEmails": 100
}
}Pro tip: Use this endpoint for Docker health checks or external monitoring services like UptimeRobot.