The Mailtrix validates email addresses through DNS, SMTP, and disposable domain checks. Use the REST API for programmatic access or the dashboard for manual bulk verification.

Verification pipeline

Quick Start

curl -X POST https://themailtrix.com/api/v1/verify \
  -H "Authorization: Bearer mtx_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com"}'

{
  "email": "user@example.com",
  "status": "valid",
  "mxRecord": "mail.example.com",
  "jobId": "9f4e1c2a-..."
}

curl -X POST https://themailtrix.com/api/v1/bulk-verify \
  -H "Authorization: Bearer mtx_live_YOUR_KEY" \
  -F "file=@emails.csv"

{
  "jobId": "a3b8c1d2-...",
  "total": 1500,
  "stats": { "valid": 1123, "invalid": 210, "risky": 88, "catch_all": 60, "unknown": 19 },
  "downloadUrl": "https://themailtrix.com/api/v1/jobs/a3b8c1d2-.../download",
  "downloadByStatus": {
    "valid":     "...download?status=valid",
    "invalid":   "...download?status=invalid",
    "risky":     "...download?status=risky",
    "catch_all": "...download?status=catch_all",
    "unknown":   "...download?status=unknown"
  }
}

Authentication

Pass your API key as a Bearer token on every request.

Authorization: Bearer mtx_live_YOUR_API_KEY

API keys

Keys are prefixed mtx_live_ and stored as SHA-256 hashes — the plaintext is never saved and cannot be recovered. Each account can hold up to 3 active keys. Create a new key if you lose one.

Best practices

• Store keys in environment variables, never in source code.
• Use separate keys per environment (production, staging, CI).
• Revoke unused keys immediately from Settings.

Credits

Credits are the billing unit. 1 credit = 1 email verified.

Credits are deducted upfront when a job starts. Your current balance is shown in the sidebar of every dashboard page. All transactions are logged under Billing → Transactions — history is kept for 12 months and older records are automatically purged.

Rate Limits

Limits are per user account using a sliding window. Exceeding a limit returns 429 Too Many Requests.

API Reference

All endpoints return JSON. Request bodies should be application/json unless noted. Dates are ISO 8601 UTC.

Verifies a single address synchronously (waits up to 30 s). Costs 1 credit.

Request

curl -X POST https://themailtrix.com/api/v1/verify \
  -H "Authorization: Bearer mtx_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com"}'

Response — 200

Timeout

Returns 504 if the worker doesn't respond within 30 s. The job keeps running — use GET /api/v1/jobs/:id to poll for the result. Credits are still charged.

Upload a CSV and receive results synchronously. Blocks up to 10 minutes. Duplicates are removed automatically — you're only charged for unique addresses.

Request — multipart/form-data

email
alice@example.com
bob@company.org

curl -X POST https://themailtrix.com/api/v1/bulk-verify \
  -H "Authorization: Bearer mtx_live_YOUR_KEY" \
  -F "file=@emails.csv"

Response — 200 (done within 10 min)

Response — 202 (still running after 10 min)

Jobs

Every verification — single or bulk — creates a job. All jobs are stored permanently in your history.

Lifecycle

Jobs stuck in queued or processing for over 6 hours are automatically failed and credits refunded.

Endpoints

Download results as CSV. Job must be completed.

Query params

CSV columns

Email Statuses

Error Codes

All errors return { "error": "..." }.

Dashboard Guide

The dashboard lets you verify without writing code. No API key needed.

Bulk Verify

1. UploadClick Add List and select a CSV file. Duplicates are stripped automatically.
2. ReviewThe job appears in your list with a credit cost. It won't start until you confirm.
3. StartClick Start Verification. Credits are deducted and processing begins.
4. DownloadOnce complete, use the Download button to get all results or filter by status.

Single Verify

1. Enter emailType any email address in the input box.
2. VerifyHit Enter or click Verify. 1 credit is charged immediately.
3. ResultThe verdict appears inline in your history within a few seconds.

API Keys

1. CreateGo to Settings → API Keys → Create Key. Give it a name.
2. CopyCopy the key from the dialog — it is shown once only and cannot be recovered.
3. UsePass it as Authorization: Bearer mtx_live_... on every API request.
4. RevokeClick the trash icon next to any key to revoke it immediately.

Each account supports a maximum of 3 active keys.

Account

Email verification

After signing up, a verification link is sent to your email address. You must click it before you can log in. If you didn't receive it, use the Resend verification email option on the sign-in page.

Change password

1. 1Go to Settings → Security.
2. 2Enter your current password, then your new password twice.
3. 3Click Save. You will remain logged in on the current device.

Sessions

Sessions expire after 7 days of inactivity. Signing out on any device invalidates that session immediately.

FAQ