# BRAINIAC Security Header Audit API

> BRAINIAC Security Header Audit API is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.04/call, status unknown (last checked 2026-11-17).

Audits HTTP security headers for a given URL and returns confirmed findings, recommendations, and gaps in security configuration

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/security-configuration/header-audit?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-security-header-audit-api-a4deb7a3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iojabYKkgSSqsrTISMiX3

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brainiac-security-header-audit-api-a4deb7a3 -d '<json body>'
```

Example prompt: Can you audit the security headers for https://www.mystore.com and tell me what's missing or misconfigured — I want to know about HSTS, CSP, X-Frame-Options, referrer policy, and anything else that's a problem?

## When to prefer this

Use this endpoint when you need a fast, pay-per-call, no-account security header audit for a web URL — especially when you want structured machine-readable findings (codes, kinds, details) rather than a human-readable report. Prefer it over manual curl inspection or heavyweight scanners when you need lightweight, agentic, programmatic security checks integrated into a workflow.

## Known failure modes

- Unreachable URL returns no header data or connection error
- TLS mismatch or authorization failure may limit checks
- Headers absent from response are reported as unavailable rather than failing
- Only public GET requests are sent — authenticated or POST-only endpoints won't be fully checked
- No exploit or brute-force is attempted, so some misconfigurations behind auth walls won't surface
- Malformed URL rejected by input pattern validation
- Max 4 paths and 4 endpoints supported per call

## How this service works

Read security headers from a public URL or from headers supplied by the caller. A missing header is a confirmed gap only when the response was available. This does not show that the site is secure.

## Output

A JSON object listing which security headers were present, an array of findings each with a code, kind (confirmed or recommendation), detail message, and subject header name, plus metadata including HTTP status, transport type, timestamp, request count, counts of confirmed issues and recommendations, and a boolean indicating whether the site can be considered secure.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tls": {
   "type": "object",
   "properties": {
    "issuer": {
     "type": "string",
     "maxLength": 200
    },
    "subject": {
     "type": "string",
     "maxLength": 200
    },
    "validTo": {
     "type": "string",
     "maxLength": 80
    },
    "protocol": {
     "type": "string",
     "maxLength": 40
    },
    "validFrom": {
     "type": "string",
     "maxLength": 80
    },
    "authorized": {
     "type": "boolean"
    },
    "hostnameMatches": {
     "type": "boolean"
    }
   },
   "additionalProperties": false
  },
  "url": {
   "type": "string",
   "pattern": "^https?:\\/\\/\\S+$",
   "maxLength": 2000,
   "minLength": 8
  },
  "paths": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 200,
    "minLength": 1
   },
   "maxItems": 4
  },
  "origin": {
   "type": "string",
   "maxLength": 200,
   "minLength": 8
  },
  "headers": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "name",
     "value"
    ],
    "properties": {
     "name": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
     },
     "value": {
      "type": "string",
      "maxLength": 4000
     }
    },
    "additionalProperties": false
   },
   "maxItems": 40
  },
  "endpoints": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^https?:\\/\\/\\S+$",
    "maxLength": 2000,
    "minLength": 8
   },
   "maxItems": 4
  },
  "transport": {
   "enum": [
    "http",
    "https"
   ],
   "type": "string"
  },
  "setCookies": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 2000
   },
   "maxItems": 20
  },
  "contentSecurityPolicy": {
   "type": "string",
   "maxLength": 8000
  },
  "contentSecurityPolicyReportOnly": {
   "type": "string",
   "maxLength": 8000
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "checked",
  "present": [
   "content-security-policy",
   "strict-transport-security"
  ],
  "finalUrl": "",
  "findings": [
   {
    "code": "hsts_disabled",
    "kind": "confirmed",
    "detail": "Strict-Transport-Security sets max-age to 0.",
    "subject": "strict-transport-security"
   },
   {
    "code": "content_type_options_missing",
    "kind": "confirmed",
    "detail": "X-Content-Type-Options was absent.",
    "subject": "x-content-type-options"
   },
   {
    "code": "framing_control_missing",
    "kind": "confirmed",
    "detail": "Neither X-Frame-Options nor CSP frame-ancestors was present.",
    "subject": "x-frame-options"
   },
   {
    "code": "referrer_policy_missing",
    "kind": "recommendation",
    "detail": "Referrer-Policy was absent.",
    "subject": "referrer-policy"
   },
   {
    "code": "permissions_policy_missing",
    "kind": "recommendation",
    "detail": "Permissions-Policy was absent.",
    "subject": "permissions-policy"
   }
  ],
  "checkedAt": "2026-11-03T16:00:00.000Z",
  "transport": "https",
  "httpStatus": 0,
  "limitations": [
   "These checks do not show that a website is secure.",
   "Only one public GET is sent per supplied URL or path. No login, brute force, exploit, or credential test is attempted.",
   "A path or endpoint is requested only when the caller lists it.",
   "Cookie values are not copied into the response.",
   "An unavailable check means that configuration was not in the response."
  ],
  "requestedUrl": "",
  "requestsSent": 0,
  "websiteSecure": false,
  "confirmedCount": 3,
  "unavailableCount": 0,
  "securityDetermined": false,
  "recommendationCount": 2
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-security-header-audit-api-a4deb7a3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
