Base URL: https://mailradar.co/api/v1
All API requests require authentication via an API key or Bearer token.
X-API-Key: mr_your_api_keyOr use a Bearer token from login:
Authorization: Bearer your_jwt_token/api/v1/test| Field | Type | Required | Description |
|---|---|---|---|
from_email | string | Yes | Sender email address to test |
to_email | string | No | Recipient email (optional) |
subject | string | No | Email subject for spam analysis |
body | string | No | Email body/HTML for content analysis |
curl -X POST https://mailradar.co/api/v1/test -H "X-API-Key: mr_your_api_key" -H "Content-Type: application/json" -d '{
"from_email": "hello@yourdomain.com",
"subject": "Welcome aboard!",
"body": "Thanks for signing up."
}'import requests
response = requests.post(
"https://mailradar.co/api/v1/test",
headers={"X-API-Key": "mr_your_api_key"},
json={
"from_email": "hello@yourdomain.com",
"subject": "Welcome aboard!",
"body": "Thanks for signing up."
}
)
print(response.json())const response = await fetch('https://mailradar.co/api/v1/test', {
method: 'POST',
headers: {
'X-API-Key': 'mr_your_api_key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
from_email: 'hello@yourdomain.com',
subject: 'Welcome aboard!',
body: 'Thanks for signing up.'
})
});
const data = await response.json();
console.log(data);$ch = curl_init('https://mailradar.co/api/v1/test');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'X-API-Key: mr_your_api_key',
'Content-Type: application/json'
],
CURLOPT_POSTFIELDS => json_encode([
'from_email' => 'hello@yourdomain.com',
'subject' => 'Welcome aboard!',
'body' => 'Thanks for signing up.'
]),
CURLOPT_RETURNTRANSFER => true
]);
$response = curl_exec($ch);
echo $response;/api/v1/keys - List all keys/api/v1/keys - Create new key/api/v1/keys/{key_id} - Revoke key/api/v1/dashboard/stats - Usage statistics/api/v1/dashboard/recent - Recent test results| Code | Meaning |
|---|---|
| 400 | Bad Request - Invalid parameters |
| 401 | Unauthorized - Invalid or missing API key |
| 403 | Forbidden - Plan limit reached |
| 429 | Too Many Requests - Rate limit exceeded |
| 500 | Server Error |