API Documentation

Integrate MailProbe email validation into your applications.

Authentication

All API requests require an API key passed via the X-API-Key header. Generate keys from the API Keys page.

curl -H "X-API-Key: mp_your_api_key_here" https://mailprobe.talkytools.com/api/validate
Rate Limiting

Default rate limit is 100 requests per hour per API key. Rate limit headers are included in every response:

  • X-RateLimit-Limit — Maximum requests per hour
  • X-RateLimit-Remaining — Requests remaining
  • X-RateLimit-Reset — Time until limit resets (Unix timestamp)
Error Responses

All errors follow a consistent format:

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Authentication required. Provide a valid session or X-API-Key header."
  }
}
401Invalid or missing API key
400Invalid request body
429Rate limit exceeded
500Server error

Endpoints

POST/api/validate
Validate Email

Validate a single email address with full verification checks.

curl -X POST https://mailprobe.talkytools.com/api/validate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: mp_your_api_key_here" \
  -d '{"email": "test@example.com"}'
POST/api/bulk
Bulk Validate

Submit up to 500 emails for batch validation. Returns a job ID for tracking progress.

curl -X POST https://mailprobe.talkytools.com/api/bulk \
  -H "Content-Type: application/json" \
  -H "X-API-Key: mp_your_api_key_here" \
  -d '{"emails": ["test@example.com", "user@gmail.com"]}'
GET/api/bulk/:jobId
Get Bulk Job Status

Check the progress and results of a bulk validation job.

curl https://mailprobe.talkytools.com/api/bulk/abc123def456 \
  -H "X-API-Key: mp_your_api_key_here"
POST/api/keys
Create API Key

Generate a new API key for programmatic access. Requires session auth (cookie).

curl -X POST https://mailprobe.talkytools.com/api/keys \
  -H "Content-Type: application/json" \
  -H "Cookie: your-session-cookie" \
  -d '{"name": "My App"}'
Risk Scoring

MailProbe computes a composite risk score from 0-100 based on multiple validation signals:

0-25Safe

Email is verified and trustworthy

26-50Low Risk

Minor concerns, likely valid

51-75Medium Risk

Multiple risk factors present

76-100High Risk

Likely invalid or malicious

Scoring Factors:

  • Invalid syntax: +40
  • No MX records: +30
  • SMTP not deliverable: +20
  • Disposable provider: +25
  • Catch-all domain: +15
  • Role account: +10
  • Has Gravatar: -10 (positive signal)