InboxReadyCheck API Documentation

REST API for email deliverability testing, authentication validation, blocklist monitoring, and infrastructure checks. Build email validation into your applications.

Authentication Endpoints Rate Limits OpenAPI Schema

Authentication

All API requests require an API key for authentication. Include your key in theX-API-Key header or as an apiKey query parameter.

# Using header (recommended)
curl -H "X-API-Key: your_api_key_here" \
  https://inboxreadycheck.com/api/validate/spf

# Using query parameter
curl https://inboxreadycheck.com/api/validate/spf?apiKey=your_api_key_here

Note: Free tier users get limited API access. Upgrade to Pro for full API access with 1,000 calls/month. Business and Enterprise plans include 10,000+ calls/month.

Base URL

https://inboxreadycheck.com/api

API Endpoints

Authentication

SPF, DKIM, DMARC, BIMI, ARC, and PTR validation endpoints

POST/api/validate/spf

Validate SPF record with 10-lookup limit checking

API Key (Pro)

POST/api/validate/dkim

Verify DKIM signature and key length

API Key (Pro)

POST/api/validate/dmarc

Analyze DMARC policy and alignment

API Key (Pro)

POST/api/validate/bimi

Validate BIMI record and VMC certificate

API Key (Pro)

POST/api/validate/arc

Verify ARC chain for forwarded emails

API Key (Pro)

POST/api/validate/ptr

Check PTR/reverse DNS record

API Key (Pro)

Monitoring

Uptime, blocklist, and infrastructure monitoring

POST/api/monitoring/uptime/check

Run SMTP, DNS, HTTP, or SSL uptime check

API Key (Pro)

POST/api/monitoring/blocklist/check

Check IP/domain across 50+ blocklists

API Key (Pro)

POST/api/monitoring/seed-test/run

Run live seed list placement test

API Key (Pro)

POST/api/monitoring/alerts/create

Create monitoring alert

API Key (Pro)

Compliance

CAN-SPAM, GDPR, CASL compliance validation

POST/api/compliance/check

Validate compliance with email regulations

No Auth Required

POST/api/compliance/unsubscribe

Validate unsubscribe link (RFC 8058)

API Key (Pro)

Content Analysis

HTML, link, and content security validation

POST/api/analyze/html

Validate HTML structure and compatibility

API Key (Pro)

POST/api/analyze/links

Analyze and validate links in email

API Key (Pro)

POST/api/analyze/bounce

Classify bounce messages

API Key (Pro)

Full Analysis

Complete email deliverability check

POST/api/analyze

Run complete deliverability analysis (all checks)

Free (Rate Limited)

Rate Limits

Tier	Rate Limit	Monthly Quota	Burst Limit
Free	5 requests/minute	100 requests/month	10 requests/minute (burst)
Professional	60 requests/minute	1,000 requests/month	120 requests/minute (burst)
Business	300 requests/minute	10,000 requests/month	600 requests/minute (burst)
Enterprise	Custom	Custom (unlimited option)	Custom

Rate limit headers are included in all responses:X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Response Format

All responses are JSON formatted with consistent structure:

{
  "success": true,
  "data": {
    // Endpoint-specific response data
  },
  "timestamp": "2025-01-20T12:00:00Z"
}

// Error response
{
  "success": false,
  "error": "Error message",
  "code": "ERROR_CODE",
  "timestamp": "2025-01-20T12:00:00Z"
}

Example Requests

SPF Validation

POST /api/validate/spf
Content-Type: application/json
X-API-Key: your_api_key

{
  "domain": "example.com"
}

// Response
{
  "success": true,
  "data": {
    "valid": true,
    "lookups": 8,
    "record": "v=spf1 include:_spf.google.com ~all",
    "issues": []
  }
}

Blocklist Check

POST /api/monitoring/blocklist/check
Content-Type: application/json
X-API-Key: your_api_key

{
  "target": "192.0.2.1",
  "tier": "pro"
}

// Response
{
  "success": true,
  "summary": {
    "totalChecked": 30,
    "listed": 0,
    "unlisted": 30
  }
}

SDKs & Resources

OpenAPI Specification

Download our complete OpenAPI 3.0 schema for auto-generating client SDKs.

Download openapi.json →

Postman Collection

Import our Postman collection to test all API endpoints interactively.

Download Collection →

Code Examples

View code examples in Python, JavaScript, PHP, and more on GitHub.

View on GitHub →

Ready to Get Started?

View API Plans