ReputeAPI Documentation¶

Welcome to the complete documentation for the DKIM/DMARC/SPF Validator API - your comprehensive solution for email security validation and mailflow protection.

What is DKIM Validator?¶

The ReputeAPI provides instant, actionable insights into your domain's email security configuration. Get a 0-100 Mailflow Security Score, identify critical issues, and receive step-by-step DNS configuration snippets to fix them.

Key Features¶

Quick Example¶

cURL:

curl -X GET "https://api.reputeapi.com/api/v1/check?domain=example.com" \
  -H "X-API-Key: your-api-key"

Python:

import requests

response = requests.get(
    "https://api.reputeapi.com/api/v1/check",
    params={"domain": "example.com"},
    headers={"X-API-Key": "your-api-key"}
)

result = response.json()
print(f"Security Score: {result['score']}/100")

JavaScript:

const response = await fetch(
  'https://api.reputeapi.com/api/v1/check?domain=example.com',
  {
    headers: {
      'X-API-Key': 'your-api-key'
    }
  }
);

const result = await response.json();
console.log(`Security Score: ${result.score}/100`);

API Response Example¶

{
  "domain": "example.com",
  "score": 85,
  "score_breakdown": {
    "current_score": 85,
    "max_score": 100,
    "total_deductions": 15,
    "potential_score_if_fixed": 100,
    "issues_by_severity": {
      "critical": 0,
      "high": 1,
      "medium": 2,
      "low": 1
    }
  },
  "issues": [
    {
      "code": "DMARC_POLICY_NONE",
      "severity": "high",
      "title": "DMARC policy set to 'none'",
      "description": "Your DMARC policy is set to 'none', which means no action is taken on failed messages.",
      "remediation": "Change your DMARC policy to 'quarantine' or 'reject'",
      "score_gain_if_fixed": 10,
      "dns_snippet": {
        "generic": "_dmarc.example.com. IN TXT \"v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com\"",
        "route53": "..."
      }
    }
  ]
}

Getting Started¶

1. Free tier includes 10 requests per minute and 1,000 requests per month

Popular Guides¶

• Python Integration Guide - Complete Python examples with best practices
• Postman Collection - Import our collection and start testing
• Understanding the Score - How the 0-100 score is calculated
• Common Scenarios - Real-world use cases and solutions

Rate Limits & Pricing¶

View detailed rate limiting documentation →

Need Help?¶

• API Issues? Check our Common Errors guide
• Questions? Read the FAQ
• Bug Reports - Open an issue
• Feature Requests - Submit on GitHub

API Endpoints¶

Quick reference to main endpoints:

View complete API reference →

What's New¶

View full changelog →