Built by Senlo.io — Need full transactional email infrastructure? Explore Senlo →

Developer API

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.

Standard REST API with Bearer auth
Real-time technical & behavioral analysis
Sandbox mode with deterministic results for testing
JSON 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", ... }, ... }
  }
}
HTTP 200 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

Self-Hosted Only: To enable API access, you must set the 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

POST/api/v2/verify

Request 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

POST/api/v2/verify/batch

Up 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

GET/api/health

Monitor 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.