SpamChap API

Overview

SpamChap is an email deliverability testing service that analyzes your emails for spam characteristics and authentication issues. Send test emails and get detailed reports with scores from 0–10.

Quick Start

1. Create a test — POST to /api/v1/tests
2. Send an email to the provided test address
3. Get results — GET /api/v1/tests/{test_id}

# Step 1: Create a test
$ curl -X POST https://spamchap.com/api/v1/tests

# Step 2: Send your email to test-abc123...@spamchap.com

# Step 3: Get results
$ curl https://spamchap.com/api/v1/tests/abc123...

API Endpoints

{
  "success": true,
  "data": {
    "test_id": "ef72bbf61f97e29ec07df5934c3c6e64",
    "email_address": "test-ef72bbf61f97e29ec07df5934c3c6e64@spamchap.com",
    "status": "pending",
    "created_at": "2025-11-03T14:59:42+00:00",
    "expires_at": "2025-11-04T14:59:42+00:00"
  }
}

{
  "success": true,
  "data": {
    "test_id": "ef72bbf61f97e29ec07df5934c3c6e64",
    "email_address": "test-ef72bbf61f97e29ec07df5934c3c6e64@spamchap.com",
    "status": "completed",
    "score": 10.0,
    "created_at": "2025-11-03T14:59:42+00:00",
    "expires_at": "2025-11-04T14:59:42+00:00",
    "results": [
      {"category": "SpamAssassin", "status": "pass", "message": "Email passed spam check", "score_impact": 3.5},
      {"category": "SPF", "status": "pass", "message": "SPF pass: 203.0.113.10 is authorized to send for example.com.", "score_impact": 1.25},
      {"category": "DKIM", "status": "pass", "message": "DKIM signature verified (2048-bit key) and aligned with the From domain.", "score_impact": 1.25},
      {"category": "DMARC", "status": "pass", "message": "DMARC pass with an enforcing policy (p=reject) — SPF and DKIM alignment.", "score_impact": 0.5},
      {"category": "Headers", "status": "pass", "message": "All required headers present", "score_impact": 0.25}
    ],
    "checks": [
      {"check_name": "SpamAssassin", "result": "pass", "details": {"message": "Email passed spam check", "score": -4.9, "required": 5, "tests": ["DKIM_SIGNED", "DKIM_VALID"]}},
      {"check_name": "blocklist", "result": "pass", "details": {"message": "Blocklist check could not be completed.", "unchecked": true}}
    ]
  }
}

Received: from mail-sender.example.com (mail-sender.example.com [203.0.113.10])
    by mx.spamchap.com with ESMTP id 4XyZab12;
    Mon, 03 Nov 2025 14:59:42 +0000 (UTC)
From: sender@example.com
To: test-ef72bbf61f97e29ec07df5934c3c6e64@spamchap.com
Subject: Test message
Date: Mon, 03 Nov 2025 14:59:42 +0000
Message-ID: <a1b2c3@example.com>
Content-Type: text/plain; charset=UTF-8

This is the plain-text body of the received email.

{
  "success": true,
  "message": "Test deleted successfully"
}

Scoring System

Weighted scoring system, 0–10 scale (higher is better):

Error Responses

All errors return JSON with appropriate HTTP status codes:

{
  "success": false,
  "error": "Test not found"
}

Status Codes

Rate Limits & Notes

• Tests expire after 24 hours
• Maximum email size: 10 MB
• Processing typically completes within seconds
• No authentication required (public API)
• Rate limited to 10 test creations per hour per IP
• Delete restricted to the IP that created the test
• If a check cannot be completed on our side (a DNS timeout, a verifier outage) it is given full credit so our problem never costs you points — and it is reported as not verified, never as a pass. In the API those checks carry "unchecked": true in their details; on the report page they show as NO DATA and are excluded from the Gmail & Yahoo compliance count. Re-run the test for a complete picture.
• SpamChap grades the message you send and its authentication. It cannot measure sending reputation over time or inbox placement, so a high score means nothing is wrong with the message — not a guarantee of the inbox.