API Reference¶

Complete reference for all ReputeAPI endpoints.

Base URL¶

https://api.reputeapi.com

Authentication¶

All API requests require an API key passed in the X-API-Key header:

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

Get your API key →

Endpoints Overview¶

Mailflow Security API (Primary)¶

Validation API (Legacy)¶

Usage & Management¶

Rate Limits¶

Rate limits vary by plan tier:

When rate limited, you'll receive a 429 Too Many Requests response:

{
  "error": "Rate limit exceeded",
  "retry_after": 60
}

Response Formats¶

All responses return JSON with appropriate HTTP status codes:

• 200 OK - Request successful
• 400 Bad Request - Invalid parameters
• 401 Unauthorized - Missing or invalid API key
• 404 Not Found - Resource not found
• 429 Too Many Requests - Rate limit exceeded
• 500 Internal Server Error - Server error

Common Parameters¶

Query Parameters¶

• domain (string, required) - Domain to validate (e.g., example.com)
• selectors (string, optional) - Comma-separated DKIM selectors (e.g., default,google,s1)
• verbose (boolean, optional) - Include verbose details (default: false)
• refresh (boolean, optional) - Bypass cache and fetch fresh data (default: false)

Pagination¶

Endpoints returning lists support pagination:

• limit (integer) - Number of results to return (default: 30)
• offset (integer) - Number of results to skip (default: 0)

Error Handling¶

All errors follow a consistent format:

{
  "error": "Invalid domain",
  "message": "The domain 'example' is not valid",
  "code": "INVALID_DOMAIN",
  "details": {
    "domain": "example",
    "reason": "Must be a fully qualified domain name"
  }
}

Interactive Documentation¶

Try the API directly in your browser:

• Swagger UI - Interactive API documentation with try-it-out functionality
• ReDoc - Beautiful API reference documentation

Need Help?¶

• Getting Started Guide
• Scoring System Explained
• Python Examples
• Postman Collection