Skip to main content

​
API Reference

The SimpleEmailAPI is organized around REST. Our API has predictable resource-oriented URLs, accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

​
Base URL

https://api.simpleemailapi.dev/v1

​
Authentication

The SimpleEmailAPI uses bearer tokens for authentication. Include your API key in the Authorization header: 
Authorization: Bearer em_live_xxxxx
Keep your API keys secure. Do not share them in publicly accessible areas such as GitHub, client-side code, etc.

​
Rate Limits

API requests are rate limited to ensure fair usage:
PlanRequests/minEmails/day
Free60100
Pro60010,000
EnterpriseCustomCustom
Rate limit headers are included in every response: 
X-RateLimit-Limit: 600
X-RateLimit-Remaining: 599
X-RateLimit-Reset: 1640995200

​
Errors

The API uses conventional HTTP response codes to indicate success or failure:
CodeDescription
200Success
201Created
400Bad Request - Invalid parameters
401Unauthorized - Invalid or missing API key
404Not Found - Resource doesn’t exist
429Too Many Requests - Rate limit exceeded
500Internal Server Error
Error responses include a JSON body with details: 
{
  "error": "invalid_request",
  "message": "The 'to' field must contain at least one recipient",
  "details": {
    "field": "to",
    "code": "required"
  }
}