Email security and deliverability analysis
Email Deliverability API
The Email Deliverability API helps businesses and developers evaluate the readiness of email domains to ensure successful email communication. It analyzes DNS records such as SPF, DKIM, DMARC, and PTR, providing insights into a domain's email configuration.
Built for email marketers, security professionals, and developers who need to enhance email security and deliverability through comprehensive domain analysis and validation.
Free tier included, no credit card required. One key works across all 49 APIs.
- Record Types
- 4
- Analysis Speed
- <500ms
- Accuracy Rate
- 99.8%
Key features
- SPF Record Validation: Checks the Sender Policy Framework records to verify authorized email senders
- DKIM Record Retrieval: Validates DomainKeys Identified Mail records for email authenticity
- DMARC Record Check: Ensures proper domain-based message authentication configuration
- PTR Record Lookup: Validates reverse DNS records for email server legitimacy
- Scoring and Recommendations: Provides actionable insights for email security improvement
Built for
- Email deliverability optimization
- Domain security assessment
- Anti-phishing protection
- Email marketing compliance
- Brand protection monitoring
- Fraud prevention systems
- Security compliance auditing
- Email infrastructure validation
Try it
Build the request for your data
Edit the parameters below and see the exact curl command and JSON response you will get. No key required to preview.
Parameters
GET /email-deliverability/v1/check?domain=example.com HTTP/1.1
Host: api.apicodex.io
Host: api.apicodex.io
X-Api-Key: YOUR_API_KEY
{
"domain": "example.com",
"score": 85,
"improvements": [
"Add a valid DKIM record to help verify the sender's identity.",
"Configure a valid reverse DNS (PTR) record for better server reputation."
],
"dns": {
"spf": "v=spf1 include:_spf.example.com ~all",
"dkim": {
"default": "v=DKIM1; k=rsa; p=..."
},
"dmarc": "v=DMARC1; p=none; rua=mailto:dmarc-reports@example.com"
},
"dns_results": {
"spf": true,
"dkim": true,
"dmarc": true
},
"reverse_dns": "mail.example.com",
"ip_in_spf": true
}Documentation
Email Deliverability API Documentation
The Email Deliverability API provides comprehensive analysis of email domain configurations to improve deliverability and security. This documentation outlines how to integrate and use the API effectively.
Base URL
https://api.apicodex.io/email-deliverabilityAuthentication
Authenticate every request with your API key: send it in an X-Api-Key header, or pass it as an ?apikey= query parameter.
{
"X-Api-Key": "YOUR_API_KEY"
}Request and response
Illustrative values. Confirm current endpoint behavior, quotas, and data freshness in the API documentation before production use.
GET /v1/check?domain=example.com HTTP/1.1
Host: api.apicodex.io
X-Api-Key: YOUR_API_KEY{
"domain": "example.com",
"score": 85,
"improvements": [
"Add a valid DKIM record to help verify the sender's identity.",
"Configure a valid reverse DNS (PTR) record for better server reputation."
],
"dns": {
"spf": "v=spf1 include:_spf.example.com ~all",
"dkim": {
"default": "v=DKIM1; k=rsa; p=..."
},
"dmarc": "v=DMARC1; p=none; rua=mailto:dmarc-reports@example.com"
},
"dns_results": {
"spf": true,
"dkim": true,
"dmarc": true
},
"reverse_dns": "mail.example.com",
"ip_in_spf": true
}Code examples
const axios = require('axios');
const options = {
method: 'GET',
url: 'https://api.apicodex.io/email-deliverability/deliverability',
params: {domain: 'example.com'},
headers: {
'X-Api-Key': 'YOUR_API_KEY'
}
};
try {
const response = await axios.request(options);
console.log(response.data);
} catch (error) {
console.error(error);
}Use Cases
Email Deliverability Testing
Assess domain readiness to improve the likelihood of successful email delivery.
Fraud Prevention
Ensure SPF, DKIM, and DMARC records are configured correctly to prevent email spoofing and phishing.
Security Compliance
Confirm that email domains follow best practices in email security and server configuration.
Pricing
Email Deliverability API Pricing
One key, one subscription, all 49 APIs. Start free and upgrade when you grow. No minimums, no lock-in.
This API costs 5 credits per request. Credits are shared across every API on your plan.
Estimate your monthly cost
Drag the slider to match your expected request volume. We will recommend the cheapest plan that covers it.
Recommended plan
Starter
$29.99 /month
Free
- All 49 APIs included
- No credit card required
- Full documentation and examples
Starter
Popular- All 49 APIs included
- Email support
- Usage dashboard and analytics
Pro
- All 49 APIs included
- Priority support
- Up to 5 API keys
Need a different plan?
Tell us about your API, volume, or support requirements.
Coming soon · MCP
Use the Email Deliverability API from your AI agent
The API Codex MCP server will expose this API, and the other 39, to Claude, Cursor and any MCP client as tools. Same key, same credits, one config entry.
FAQ
Frequently asked questions
SPF (Sender Policy Framework), DKIM (DomainKeys Identified Mail), and DMARC (Domain-based Message Authentication, Reporting & Conformance) are three complementary email authentication protocols that work together to protect your domain. SPF verifies that emails claiming to be from your domain actually come from authorized mail servers by checking the sender's IP address against a published list. DKIM uses cryptographic signatures to verify that email content hasn't been altered in transit and that the message was authorized by the domain owner. DMARC builds on both SPF and DKIM by specifying what receiving servers should do when authentication fails and provides reporting mechanisms to monitor your email ecosystem. Together, these three protocols create a robust defense against email spoofing, phishing attacks, and domain impersonation.
The deliverability score is calculated based on the presence and proper configuration of essential DNS records (SPF, DKIM, DMARC), the validity of PTR records, and the overall health of the domain's email infrastructure. The score ranges from 0-100, with higher scores indicating better deliverability prospects. Each component contributes to the overall score, with properly configured security records significantly boosting the rating.
A PTR (Pointer) record, also known as reverse DNS, maps an IP address back to a domain name. Many email servers check PTR records to verify that incoming messages are coming from legitimate servers. Without a valid PTR record, your emails may be flagged as spam or rejected entirely by receiving servers. The PTR record should match the domain used in your email's HELO/EHLO commands for best deliverability results.
The API provides specific improvement suggestions based on your domain's current configuration. To implement these improvements, you'll typically need to add or modify DNS records through your domain registrar or DNS hosting provider. For SPF, DKIM, and DMARC records, you'll need to add TXT records with specific formats. For PTR records, you may need to contact your email hosting provider or ISP, as these records are typically managed at the IP level rather than the domain level.
It's recommended to check your domain's deliverability at least monthly, especially for businesses that rely heavily on email communication. Additionally, you should check after making any changes to your email infrastructure, DNS records, or when switching email service providers. Regular monitoring helps ensure that your email configuration remains optimal and allows you to quickly address any issues that might affect deliverability. For high-volume senders or businesses where email is mission-critical, weekly checks or even automated daily monitoring may be appropriate. Set up alerts to notify you when your deliverability score drops below acceptable thresholds.
Yes, the Email Deliverability API excels at identifying email spoofing vulnerabilities through comprehensive DMARC analysis. The API checks if your DMARC policy is set to 'none', 'quarantine', or 'reject' — domains with no DMARC policy or a policy set to 'none' are vulnerable to spoofing attacks where malicious actors can send emails that appear to come from your domain. The API also validates that your SPF records aren't overly permissive (using '+all' is a major security risk) and checks for the presence of DKIM selectors. By examining all three authentication mechanisms together, the API can identify specific attack vectors and provide actionable recommendations to harden your email security posture. Regular scans help ensure unauthorized parties cannot impersonate your domain to commit phishing or fraud.
Keep building
Related APIs
Validate email addresses with comprehensive syntax checking, DNS verification, and deliverability scoring.
Query DNS records including MX, TXT, SPF, and other record types for domain analysis.
Extract structured data from email messages including headers and routing information.