Email API Docs

Generate disposable mails and pull their verification codes (OTPs) over HTTP. A plan subscription unlocks the API and includes up to 10,000 verification codes per day; each generate and fetch counts toward that daily allowance. View plans.

Authentication

Send your key on every request as a Bearer token or an X-API-Key header. An active subscription is required; calls draw from your plan's daily allowance.

Authorization: Bearer qotp_xxxxxxxxxxxxxxxx
# or
X-API-Key: qotp_xxxxxxxxxxxxxxxx

1. Generate a mail

Counts as one operation against your daily allowance.

curl -X POST https://qonixcore.com/api/otp/generate \
  -H "Authorization: Bearer qotp_xxx"

# → { "success": true, "alias": "abc123@mail.qonixcore.com",
#     "expiresAt": "...", "allowanceRemaining": 9999 }

2. Get the verification code

Long-polls up to timeout_ms (max 120000) for a fresh code. A delivered code counts toward your daily allowance. No code within the timeout = nothing counted.

curl "https://qonixcore.com/api/otp/fetch?email=abc123@mail.qonixcore.com&timeout_ms=60000" \
  -H "Authorization: Bearer qotp_xxx"

# → { "success": true, "otp": "123456", "subject": "Your code",
#     "receivedAt": "...", "allowanceRemaining": 9998 }

# no code yet:
# → { "success": false, "notFound": true, "allowanceRemaining": 9999 }

3. Check your allowance

curl https://qonixcore.com/api/otp/account \
  -H "Authorization: Bearer qotp_xxx"

# → { "success": true, "plan": "monthly", "dailyAllowance": 10000,
#     "allowanceRemaining": 9998, "renewsAt": "..." }

Webhooks

POST <your-url>
Content-Type: application/json
X-Qonix-Signature: sha256=<hmac>   # only if you set a secret

{
  "event": "otp.received",
  "email": "abc123@mail.qonixcore.com",
  "otp": "123456",
  "subject": "Your code",
  "received_at": "2026-06-13T22:00:00.000Z"
}

If you set a secret, verify the signature: HMAC-SHA256(secret, rawBody) hex, compared against the X-Qonix-Signature header (after the sha256= prefix).

Plans & billing

The API is subscription-based. Choose a billing period from 1 day up to 5 years — for example $9 (1-Day), $32 (7-Day), $84 (Monthly) or $720 (1 Year), with longer periods saving up to 60%. Every plan includes up to 10,000 verification codes per day; the allowance resets daily and your subscription renews automatically.