Documentation version: Latest (v1)

Reference

API reference

Complete endpoint catalog for Mail API, templates, OTP flows, email verification, and legacy compatibility aliases. Every endpoint page includes code snippets for all supported programming languages.

Mail

Queue and inspect transactional email sends.

POST/api/v1/emails

Queue an email

Queues transactional or template mail with optional sender routing and priority.

GET/api/v1/emails?page=1&limit=20

List queued/sent emails

Returns paginated send log for the authenticated user.

Templates

Manage and send template-driven email.

POST/api/v1/templates/send

Send using a template

Queues email from a saved template with runtime vars.

POST/api/v1/templates/send-test

Send template test email

Queues a safe test email for account health checks.

GET/api/v1/templates?page=1&limit=20

List templates

Paginated list of accessible templates.

GET/api/v1/templates/{templateId}

Get a single template

Returns full template payload including html/text body.

Instant OTP (public/server)

OTP APIs with public token support.

POST/api/v1/instant-otp/send

Send instant OTP

Generates and sends OTP immediately over SMTP in request cycle.

POST/api/v1/instant-otp/verify

Verify instant OTP

Consumes OTP session and marks verification complete.

GET/api/v1/instant-otp/verifications?limit=50

List instant OTP verifications

Returns verification history for analytics and reconciliation.

Backend OTP

Server-only OTP APIs with server_otp key scope.

POST/api/v1/backend-otp/send

Send backend OTP

Server-to-server OTP send using API key only.

POST/api/v1/backend-otp/verify

Verify backend OTP

Verifies backend OTP sessions with server credentials.

GET/api/v1/backend-otp/verifications?limit=50

List backend OTP verifications

Paginated verification history for server OTP keys.

Email verification

Email verification OTP flow for signup and identity checks.

POST/api/v1/email-verification/send

Send email verification code

Server key protected email verification flow with hosted verify URL in response.

POST/api/v1/email-verification/verify

Verify email verification code

Consumes verification session and returns verified=true on success.

Legacy aliases

Back-compat routes retained for existing clients.

POST/api/v1/otp/send

Legacy OTP send alias

Compatibility alias for instant OTP send.

POST/api/v1/otp/verify

Legacy OTP verify alias

Compatibility alias for instant OTP verify.

GET/api/v1/otp/verifications?limit=50

Legacy OTP verifications alias

Compatibility alias for instant OTP verification history endpoint.