Docs menu

HTTP and security headers

Grade a website's HTTPS redirects, HSTS, Content-Security-Policy, cookies and other security headers.

GET /v1/http

Price
Costs 2 credits per call; cached answers cost the same. Calls that fail upstream (502) are free.
Cache
Answers are cached for up to 15 minutes; send fresh=true to ask the source again.
MCP tool
check_http

Run it in the browser

Query parameters

Query parameters
NameTypeDescription
url (required)stringA domain or URL; only the site (scheme and host) is used.
freshbooleanSkip the cache and ask the source again; costs the same.

Response

Response fields
NameTypeDescription
tool (required)string
target (required)string
status (required)"ok" | "partial" | "error"
fetched_atstring
cachedboolean
credits_usedintegerCredits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in
summary (required)string
scoreinteger or null
findingsarray of object
credits_remaining (required)integerYour balance after this call. It can be below zero after a refund; free tools still work then
data (required)objectThis tool's result
data.host (required)string
data.alternate_host (required)string or null
data.reachable (required)boolean
data.no_websiteboolean
data.entry_points (required)array of object
data.entry_points.start_url (required)string
data.entry_points.final_url (required)string or null
data.entry_points.final_status (required)integer or null
data.entry_points.hops (required)array of object
data.entry_points.outcome (required)"ok" | "loop" | "too_many" | "no_address" | "connect" | "refused" | "tls_failed" | "timeout" | "blocked" | "ipv6_only" | "error"
data.primary_url (required)string or null
data.primary_status (required)integer or null
data.http_version (required)string or null
data.headers (required)object
data.hsts (required)object
data.hsts.present (required)boolean
data.hsts.max_age (required)integer or null
data.hsts.include_subdomains (required)boolean
data.hsts.preload (required)boolean
data.hsts.problems (required)array of string
data.preload (required)object
data.preload.eligible (required)boolean
data.preload.applicable (required)boolean
data.preload.missing (required)array of string
data.csp (required)array of object
data.csp.source (required)"header" | "meta"
data.csp.report_only (required)boolean
data.csp.directives (required)object
data.csp.weaknesses (required)array of string
data.csp.upgrade_insecure_requests (required)boolean
data.framing (required)"frame-ancestors" | "x-frame-options" | "none"
data.referrer_policy (required)string or null
data.permissions_policy (required)array of string
data.coop (required)string or null
data.coep (required)string or null
data.corp (required)string or null
data.cookies (required)array of object
data.cookies.name (required)string
data.cookies.domain (required)string or null
data.cookies.path (required)string or null
data.cookies.secure (required)boolean
data.cookies.http_only (required)boolean
data.cookies.same_site (required)string or null
data.cookies.session (required)boolean
data.cookies.prefix_ok (required)boolean
data.cookies.over_https (required)boolean
data.disclosed (required)array of object
data.disclosed.header (required)string
data.disclosed.value (required)string
data.disclosed.version (required)string
data.http2 (required)boolean or null
data.http3_advertised (required)boolean

Errors

  • 400 Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`)
  • 401 Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)
  • 402 Balance below the call's price (`insufficient_credits`)
  • 403 Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`)
  • 429 Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged
  • 500 Unexpected error (`internal_error`)
  • 502 Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to
  • 503 Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged

Example

curl

curl
curl "https://api.dnssuper.com/v1/http?url=example.com" \
  -H "Authorization: Bearer $DNSSUPER_API_KEY"

Python

Python (httpx)
import os

import httpx

client = httpx.Client(
    base_url="https://api.dnssuper.com",
    headers={"Authorization": f"Bearer {os.environ['DNSSUPER_API_KEY']}"},
    timeout=60,
)
response = client.get("/v1/http", params={
    "url": "example.com",
})
response.raise_for_status()
result = response.json()
print(result["summary"], result["credits_used"])

TypeScript

TypeScript (fetch)
const response = await fetch(`https://api.dnssuper.com/v1/http?${new URLSearchParams({"url":"example.com"})}`, {
  headers: { Authorization: `Bearer ${process.env.DNSSUPER_API_KEY}` },
});
if (!response.ok) throw new Error((await response.json()).error.message);
const result = await response.json();
console.log(result.summary, result.credits_used);
Example response
Example response
{
  "tool": "security-headers",
  "target": "https://example.com/",
  "status": "ok",
  "fetched_at": "2026-11-14T10:00:00Z",
  "cached": false,
  "credits_used": 2,
  "summary": "Grade A (100/100) for example.com. HTTPS, redirects and the main security headers are in place.",
  "score": 100,
  "findings": [],
  "data": {
    "host": "example.com",
    "alternate_host": "www.example.com",
    "reachable": true,
    "no_website": false,
    "entry_points": [
      {
        "start_url": "http://example.com/",
        "final_url": "https://www.example.com/",
        "final_status": 200,
        "hops": [
          {
            "url": "http://example.com/",
            "status": 301,
            "location": "https://example.com/",
            "elapsed_ms": 12,
            "cookie_names": [],
            "kind": "http"
          },
          {
            "url": "https://example.com/",
            "status": 301,
            "location": "https://www.example.com/",
            "elapsed_ms": 12,
            "cookie_names": [],
            "kind": "http"
          },
          {
            "url": "https://www.example.com/",
            "status": 200,
            "elapsed_ms": 12,
            "cookie_names": [
              "__Host-session"
            ],
            "kind": "http"
          }
        ],
        "outcome": "ok"
      },
      {
        "start_url": "https://example.com/",
        "final_url": "https://www.example.com/",
        "final_status": 200,
        "hops": [
          {
            "url": "https://example.com/",
            "status": 301,
            "location": "https://www.example.com/",
            "elapsed_ms": 12,
            "cookie_names": [],
            "kind": "http"
          },
          {
            "url": "https://www.example.com/",
            "status": 200,
            "elapsed_ms": 12,
            "cookie_names": [
              "__Host-session"
            ],
            "kind": "http"
          }
        ],
        "outcome": "ok"
      },
      {
        "start_url": "http://www.example.com/",
        "final_url": "https://www.example.com/",
        "final_status": 200,
        "hops": [
          {
            "url": "http://www.example.com/",
            "status": 301,
            "location": "https://www.example.com/",
            "elapsed_ms": 12,
            "cookie_names": [],
            "kind": "http"
          },
          {
            "url": "https://www.example.com/",
            "status": 200,
            "elapsed_ms": 12,
            "cookie_names": [
              "__Host-session"
            ],
            "kind": "http"
          }
        ],
        "outcome": "ok"
      },
      {
        "start_url": "https://www.example.com/",
        "final_url": "https://www.example.com/",
        "final_status": 200,
        "hops": [
          {
            "url": "https://www.example.com/",
            "status": 200,
            "elapsed_ms": 12,
            "cookie_names": [
              "__Host-session"
            ],
            "kind": "http"
          }
        ],
        "outcome": "ok"
      }
    ],
    "primary_url": "https://www.example.com/",
    "primary_status": 200,
    "http_version": "HTTP/1.1",
    "headers": {
      "strict-transport-security": "max-age=63072000; includeSubDomains; preload",
      "content-security-policy": "default-src 'self'; script-src 'self' 'nonce-r4nd0m'; object-src 'none'; base-uri 'none'; frame-ancestors 'self'",
      "x-frame-options": "SAMEORIGIN",
      "x-content-type-options": "nosniff",
      "referrer-policy": "strict-origin-when-cross-origin",
      "permissions-policy": "camera=(), microphone=(), geolocation=()",
      "cross-origin-opener-policy": "same-origin",
      "server": "nginx",
      "alt-svc": "h3=\":443\"; ma=86400"
    },
    "hsts": {
      "present": true,
      "max_age": 63072000,
      "include_subdomains": true,
      "preload": true,
      "problems": []
    },
    "preload": {
      "eligible": true,
      "applicable": true,
      "missing": []
    },
    "csp": [
      {
        "source": "header",
        "report_only": false,
        "directives": {
          "default-src": [
            "'self'"
          ],
          "script-src": [
            "'self'",
            "'nonce-r4nd0m'"
          ],
          "object-src": [
            "'none'"
          ],
          "base-uri": [
            "'none'"
          ],
          "frame-ancestors": [
            "'self'"
          ]
        },
        "weaknesses": [],
        "upgrade_insecure_requests": false
      }
    ],
    "framing": "frame-ancestors",
    "referrer_policy": "strict-origin-when-cross-origin",
    "permissions_policy": [
      "camera",
      "microphone",
      "geolocation"
    ],
    "coop": "same-origin",
    "cookies": [
      {
        "name": "__Host-session",
        "path": "/",
        "secure": true,
        "http_only": true,
        "same_site": "lax",
        "session": true,
        "prefix_ok": true,
        "over_https": true
      }
    ],
    "disclosed": [],
    "http2": true,
    "http3_advertised": true
  },
  "credits_remaining": 498
}

MCP

MCP tool call
{
  "tool": "check_http",
  "arguments": {
    "url": "example.com"
  }
}
Compact MCP output
Grade A (100/100) for example.com. HTTPS, redirects and the main security headers are in place.
Score: 100/100
http://example.com/ -> 301 -> 301 -> https://www.example.com/ 200
https://example.com/ -> 301 -> https://www.example.com/ 200
http://www.example.com/ -> 301 -> https://www.example.com/ 200
https://www.example.com/ 200
Present: HSTS, CSP, X-Content-Type-Options, Referrer-Policy, Permissions-Policy, framing protection; HTTP/2, HTTP/3 advertised
No issues found.
Credits: 2 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC