{"uid":"cap__RRY2-4K6iRdGTKmrVaWk","slug":"inboxguards-email-deliverability-security-report-2c5a11e4","name":"InboxGuards Email Deliverability & Security Report","description":"Send a real email to a one-time address and get a deliverability and security report: SPF, DKIM, DMARC, ARC, sending IP reverse DNS, SpamCop, MTA-STS/TLS-RPT, BIMI, List-Unsubscribe, header and content checks. Free to create a test; pay only to read a finished report.","url":"https://api.inboxguardstest.com/v1/report?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"headers":{"type":"object","required":["X-Read-Token"],"properties":{"X-Read-Token":{"type":"string","description":"read_token returned once by POST /v1/tests"}},"additionalProperties":{"type":"string"}},"queryParams":{"type":"object","required":["test_id"],"properties":{"test_id":{"type":"string","pattern":"^[a-z2-7]{12}$","description":"test_id from POST /v1/tests"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["schema_version","test_id","received_at","score","grade","top_fixes","suggestions","message","connection","authentication","transport_policy","links","findings","notes"],"properties":{"grade":{"enum":["A","B","C","D","F"],"type":"string"},"links":{"type":"object","description":"link reputation status per domain (Google Web Risk; 'not_checked' until configured)"},"notes":{"type":"array","items":{"type":"string"}},"score":{"type":"integer","maximum":100,"minimum":0},"message":{"type":"object","description":"size, From/envelope domains, Message-ID domain, List-Unsubscribe, content facts (no body text)"},"test_id":{"type":"string"},"findings":{"type":"array","items":{"type":"object","required":["id","area","severity","title"],"properties":{"id":{"type":"string"},"fix":{"type":"string"},"area":{"type":"string"},"title":{"type":"string"},"detail":{"type":"string"},"severity":{"enum":["pass","info","warn","fail"],"type":"string"}}}},"top_fixes":{"type":"array","items":{"type":"object","required":["id","title","fix"],"properties":{"id":{"type":"string"},"fix":{"type":"string"},"title":{"type":"string"}}},"description":"Up to 3 fail/warn items to fix first"},"cloudflare":{"type":"object","description":"Cloudflare's own Authentication-Results and spam score for the inbound hop"},"connection":{"type":"object","properties":{"ip":{"type":"string"},"ptr":{"type":"array","items":{"type":"string"}},"helo":{"type":"string"},"fcrdns":{"type":"boolean"},"source":{"type":"string"},"spamcop":{"type":"string"}},"description":"sending IP and HELO from Cloudflare's trace header, PTR, forward-confirmed rDNS, SpamCop"},"analyzed_at":{"type":"string","format":"date-time"},"received_at":{"type":"string","format":"date-time"},"suggestions":{"type":"array","items":{"type":"object","required":["id","title","fix"],"properties":{"id":{"type":"string"},"fix":{"type":"string"},"title":{"type":"string"}}},"description":"Optional improvements; do not lower the score"},"authentication":{"type":"object","properties":{"arc":{"type":"object"},"spf":{"type":"object"},"bimi":{"type":"object"},"dkim":{"type":"array"},"dmarc":{"type":"object"}},"description":"SPF, DKIM (each signature: domain, selector, result, aligned, key_bits), DMARC (result, policy, alignment), ARC, BIMI"},"partial_errors":{"type":"array","items":{"type":"string"}},"schema_version":{"type":"string"},"transport_policy":{"type":"object","description":"sender domain MTA-STS and TLS-RPT records"}}}}}}},"responseSchema":{"type":"json","example":{"grade":"B","links":{"reason":"link reputation not configured","status":"not_checked","checked":[],"unchecked_domains":["example.com"]},"notes":["These are deliverability signals, not a guarantee of inbox placement."],"score":88,"message":{"size_bytes":5321,"from_domain":"example.com","body_analyzed":true,"envelope_from":"bounce@example.com"},"test_id":"abcdefgh2345","findings":[{"id":"spf_pass","area":"spf","title":"SPF pass for example.com","severity":"pass"}],"top_fixes":[{"id":"list_unsubscribe_no_one_click","fix":"Add an https unsubscribe URL plus List-Unsubscribe-Post: List-Unsubscribe=One-Click.","title":"List-Unsubscribe present but not one-click"}],"cloudflare":{"accepted":true,"spam_score":2},"connection":{"ip":"192.0.2.10","ptr":["mail.example.com"],"helo":"mail.example.com","fcrdns":true,"source":"cloudflare_received","spamcop":"not_listed"},"received_at":"2026-10-10T06:48:16.999Z","suggestions":[],"authentication":{"spf":{"result":"pass","evaluated":true},"dkim":[{"domain":"example.com","result":"pass","aligned":true,"key_bits":2048,"selector":"s1"}],"dmarc":{"policy":"quarantine","result":"pass"}},"partial_errors":[],"schema_version":"1.0","transport_policy":{"mta_sts":{"record":false},"tls_rpt":false,"inbound_tls_observed":false}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_O_w8mnN6d1--5p_WWZZbQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a completed email deliverability and security audit report (SPF, DKIM, DMARC, spam, TLS, BIMI, headers) for a previously submitted test email.","exampleAgentPrompt":"Can you pull the deliverability report for my InboxGuards test — the test ID is ab3defgh2345 and the read token is my-read-token — and tell me the score, grade, and top things I need to fix?","exampleUseCases":[{"title":"Pre-campaign sender reputation check","prompt":"Before I send my newsletter next week, I ran an InboxGuards test with ID mn4opqrs6789 and token tok_abc123 — can you fetch the report and tell me my score, whether SPF/DKIM/DMARC all passed, and what the top fixes are?"},{"title":"Diagnose spam folder delivery issue","prompt":"My transactional emails keep hitting spam — I set up an InboxGuards test (test ID: zx7cvbnm1234, read token: rk_xyz789) and want to know what authentication or header problems the report found and how severe they are."},{"title":"Verify one-click unsubscribe compliance","prompt":"I need to confirm my marketing emails meet List-Unsubscribe one-click requirements — can you get the InboxGuards report for test ID qw2ertyu5678 (read token: rt_comply99) and specifically check the List-Unsubscribe finding and any related suggestions?"}],"resultDescription":"Returns a JSON report containing an overall deliverability score (0–100), a letter grade (A–F), authentication results (SPF, DKIM with selector/key bits/alignment, DMARC policy and result), sending connection details (IP, PTR/FCrDNS, HELO, SpamCop status), transport policy (MTA-STS, TLS-RPT, observed inbound TLS), message metadata (size, From/envelope domains, Message-ID, List-Unsubscribe), link reputation status per domain, an array of all findings with severity (pass/info/warn/fail) and fix guidance, up to 3 prioritized top_fixes, and any informational notes.","failureModes":["Report not yet ready — test email not received yet; poll again after a delay","Invalid or expired test_id — returns 404 or error; ensure test_id matches the pattern ^[a-z2-7]{12}$","Invalid or mismatched X-Read-Token — returns 401/403; token is issued once by POST /v1/tests and tied to the test_id","Payment not completed — x402 payment required before report is returned","test_id not found — test may have expired or never been created","Partial errors in report — some checks may be inconclusive if email was malformed or headers were stripped"],"whenToPreferThis":"Use this endpoint when you need a comprehensive, structured audit of an actual sent email's deliverability and authentication properties — including SPF, DKIM, DMARC, SpamCop, MTA-STS, BIMI, and header analysis — in one call. Prefer this over manual DNS lookup tools when you want a scored, graded, actionable report with prioritized fixes. It is specifically suited for pre-send validation of email campaigns, troubleshooting inbox placement failures, and compliance checks (e.g. one-click unsubscribe).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:30:13.390Z","isFirstParty":false,"canonicalSlug":"inboxguards-email-deliverability-security-report-2c5a11e4"}