Support: support@tinplate.dev · Zero-Retention Edge Security Support Trust Center DPA GitHub Issues
Security & Secrets Tier 2 All-Access

Security Headers & CSP Checker API — Grade HTTP Response Headers (A+ to F)

Audit CSP, HSTS, and browser security headers with an A+ to F grade and fix snippets. Audit HTTP security headers (CSP, HSTS, X-Frame-Options, COOP/COEP, Permissions-Policy) from a header map or live URL and get an A+ to F grade.

Interactive Sandbox · No API Key Required 200 OK · Ready
POST /v1/security-headersinput
200 OK sample / live responsejson
{
  "ok": true,
  "data": {
    "target_url": null,
    "http_status": null,
    "score": 55,
    "grade": "D",
    "checks": {
      "hsts": {
        "status": "pass",
        "score": 25,
        "max_score": 25,
        "value": "max-age=63072000; includeSubDomains; preload",
        "issues": [],
        "fix": null
      },
      "csp": {
        "status": "fail",
        "score": 0,
        "max_score": 25,
        "value": null,
        "issues": [
          "Missing Content-Security-Policy header"
        ],
        "fix": "default-src 'self'; object-src 'none'; base-uri 'self'; frame-ancestors 'none'"
      },
      "x_content_type_options": {
        "status": "pass",
        "score": 15,
        "max_score": 15,
        "value": "nosniff",
        "issues": [],
        "fix": null
      },
      "frame_protection": {
        "status": "pass",
        "score": 15,
        "max_score": 15,
        "value": "DENY",
        "issues": [],
        "fix": null
      },
      "referrer_policy": {
        "status": "fail",
        "score": 0,
        "max_score": 10,
        "value": null,
        "issues": [
          "Missing Referrer-Policy header"
        ],
        "fix": "strict-origin-when-cross-origin"
      },
      "permissions_policy": {
        "status": "warn",
        "score": 0,
        "max_score": 10,
        "value": null,
        "issues": [
          "Missing Permissions-Policy header"
        ],
        "fix": "geolocation=(), microphone=(), camera=()"
      }
    },
    "cors": {
      "allow_origin": null,
      "allow_credentials": null,
      "wildcard": false,
      "misconfigured": false
    },
    "fixes": [
      {
        "header": "Content-Security-Policy",
        "priority": "high",
        "recommended_value": "default-src 'self'; object-src 'none'; base-uri 'self'; frame-ancestors 'none'"
      },
      {
        "header": "Referrer-Policy",
        "priority": "medium",
        "recommended_value": "strict-origin-when-cross-origin"
      },
      {
        "header": "Permissions-Policy",
        "priority": "low",
        "recommended_value": "geolocation=(), microphone=(), camera=()"
      }
    ]
  },
  "meta": {
    "request_id": "req_sh_01",
    "ms": 1
  }
}
OpenAPI 3.0.3 Get All-Access Key ($29/mo) No signup. No payload storage.
Quickstart Code Examples
curl -X POST "https://api.tinplate.dev/v1/security-headers" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TINPLATE_KEY" \
  -d '{"headers":{"strict-transport-security":"max-age=63072000; includeSubDomains; preload","x-content-type-options":"nosniff","x-frame-options":"DENY"}}'
import { TinplateClient } from "@tinplate/sdk";

const tinplate = new TinplateClient({
  apiKey: process.env.TINPLATE_API_KEY!,
});

const { data, meta } = await tinplate.call("/v1/security-headers", {
  "headers": {
    "strict-transport-security": "max-age=63072000; includeSubDomains; preload",
    "x-content-type-options": "nosniff",
    "x-frame-options": "DENY"
  }
});
console.log(`[${meta.ms} ms]`, data);
import requests

response = requests.post(
    "https://api.tinplate.dev/v1/security-headers",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_TINPLATE_KEY",
    },
    json={
  "headers": {
    "strict-transport-security": "max-age=63072000; includeSubDomains; preload",
    "x-content-type-options": "nosniff",
    "x-frame-options": "DENY"
  }
}
)
print(response.json())
const response = await fetch("https://api.tinplate.dev/v1/security-headers", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_TINPLATE_KEY",
  },
  body: JSON.stringify({
  "headers": {
    "strict-transport-security": "max-age=63072000; includeSubDomains; preload",
    "x-content-type-options": "nosniff",
    "x-frame-options": "DENY"
  }
}),
});
const result = await response.json();
console.log(result);
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tinplate_security_headers",
    "arguments": {
      "headers": {
        "strict-transport-security": "max-age=63072000; includeSubDomains; preload",
        "x-content-type-options": "nosniff",
        "x-frame-options": "DENY"
      }
    }
  }
}
OpenAPI 3.0.3 Schema Contract

Request Parameters & Response Schema Reference

Request Body Parameters (POST /v1/security-headers)

ParameterType & ConstraintsDescription
url optional string
maxLen: 2048
Target URL to fetch via private fetcher and inspect security headers.
headers optional object Optional raw response headers to audit offline without making an HTTP request.

Response data Object Fields (200 OK)

FieldTypeDescription
target_url string | null Field 'target_url'
http_status integer | null Field 'http_status'
score integer Field 'score'
grade "A" | "B" | "C" | "D" | "F" Field 'grade'
checks object Field 'checks'
cors object Field 'cors'
fixes object[] Field 'fixes'

What HTTP Security Header Scanner API Detects & Validates

  • Evaluates Content-Security-Policy (flags unsafe-inline, unsafe-eval, wildcard sources, missing frame-ancestors)
  • Checks Strict-Transport-Security max-age, includeSubDomains, and preload readiness
  • Audits X-Content-Type-Options, X-Frame-Options, Referrer-Policy, Permissions-Policy, and CORP/COOP/COEP
  • Flags information-disclosure headers (Server version banners, X-Powered-By, X-AspNet-Version)
  • Accepts either a raw headers JSON object or a public URL to inspect live
Honest Engineering Boundaries

Known Limitations & Test Verification

Release: v1.0.39 · Verified: 16 November 2026 · Portfolio Median: 0.318 ms in-Worker V8 compute (add 15–65 ms HTTPS RTT) · See Full Portfolio Benchmarks →

  • Evaluates HTTP response headers only; does not scan page HTML for inline <meta http-equiv> CSP tags unless headers are extracted first.
  • Tested v1.0.4 (14 November 2026).

Direct All-Access & Marketplace Plans

Direct Polar All-Access Keys unlock all 42 APIs (49 endpoints), /v1/pipeline, and /mcp on api.tinplate.dev: Pro ($29/mo · 120 req/min · 100k/mo · 128 KB) or Team ($79/mo · 300 req/min · 500k/mo · 256 KB).

PlanMonthly PriceIncluded RequestsRate LimitMax PayloadBest For
BASIC$0.00 / mo500 / month10 req / min64 KBEvaluation & CI smoke tests
PRO$9.99 / mo15,000 / month60 req / min128 KBSolo devs & production apps
ULTRA$29.99 / mo100,000 / month300 req / min256 KBGrowing SaaS & multi-agent pipelines
MEGA$79.99 / mo500,000 / month1,000 req / min256 KBHigh-volume enterprise workloads

Frequently Asked Questions

Can I scan internal staging apps without exposing them to the internet?

Yes! Pass the response headers map directly in the headers JSON field—no outbound URL fetch is required.

Does it parse CSP directives in detail?

Yes, it parses every CSP directive and flags dangerous tokens like 'unsafe-inline', 'unsafe-eval', and data:/http: wildcards.

Does it provide copy-paste remediation headers?

Yes, each finding includes a recommended header value snippet.

Zero Payload Logging

Data Handling, Privacy & Proxy Disclosure

Stateless header evaluation; zero logging.

Worker Zero-Logging Guarantee: Cloudflare Workers Observability and invocation logging are disabled (observability.enabled = false, head_sampling_rate = 0, invocation_logs = false). Requests via RapidAPI or Zyla traverse marketplace proxies; use a Direct Bearer Key for zero-intermediary routing.

Related Tinplate APIs

POST /v1/ssrf-firewall Security & Secrets

Agent URL & SSRF Firewall API

Validate URLs and redirect chains against SSRF, private IPs, and cloud metadata targets.

POST /v1/email-dns Live

Email DNS Deliverability Auditor API

Audit MX, SPF 10-lookup limits, DMARC, DKIM, BIMI, and MTA-STS with a 0–100 score.

POST /v1/robots-llms-analyzer Developer Utilities

robots.txt & llms.txt AI Crawler Analyzer & Generator API

Audit which AI crawlers your robots.txt allows and generate a valid llms.txt file.