# BRAINIAC Exposed File Check API

> BRAINIAC Exposed File Check API is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.05/call, status unknown (last checked 2026-11-17).

Checks a website for exposed sensitive files and paths (e.g. .env, config files) by sending public GET requests and analyzing the responses.

## Facts

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

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-exposed-file-check-api-b3c430e7 -d '<json body>'
```

Example prompt: Can you check whether https://example.com has any exposed sensitive files — specifically check the paths /.env and /config.json — and tell me if any of them are publicly accessible?

## When to prefer this

Use this endpoint when you need a lightweight, no-account, pay-per-call check for exposed sensitive files on a public web server. It is ideal for pre-launch audits, CI/CD security gates, or spot-checking a client site without setting up a full vulnerability scanner. It is not a comprehensive penetration test — it only sends a single public GET per path with no authentication, brute force, or exploit attempts.

## Known failure modes

- Path contains '..' or leaves the host — returns 'path_rejected' finding with unavailable status
- Target URL is unreachable or times out — returns unavailable status for all paths
- Invalid URL format — rejected by input schema validation
- Too many paths supplied (max 4) — schema validation error
- TLS mismatch or unauthorized certificate — noted in TLS input but check still proceeds as configured

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

Returns a list of checked paths with their exposure status (exposed true/false), HTTP status code, and content type for each. Also includes a list of security findings with codes and details, a timestamp of when the check ran, counts of confirmed/unavailable findings, a websiteSecure boolean, a securityDetermined flag, and a list of limitations describing what the check does and does not cover.

## 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": {
  "paths": [
   {
    "path": "/.env",
    "exposed": false,
    "httpStatus": 0,
    "contentType": ""
   },
   {
    "path": "/../secret",
    "exposed": false,
    "httpStatus": 0,
    "contentType": ""
   }
  ],
  "status": "unavailable",
  "findings": [
   {
    "code": "path_rejected",
    "kind": "unavailable",
    "detail": "The path leaves the supplied host, contains .., or could not be parsed. It was not requested.",
    "subject": "/.env"
   },
   {
    "code": "path_rejected",
    "kind": "unavailable",
    "detail": "The path leaves the supplied host, contains .., or could not be parsed. It was not requested.",
    "subject": "/../secret"
   }
  ],
  "checkedAt": "2026-11-03T16:00:00.000Z",
  "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."
  ],
  "requestsSent": 0,
  "websiteSecure": false,
  "confirmedCount": 0,
  "unavailableCount": 2,
  "securityDetermined": false,
  "recommendationCount": 0
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-exposed-file-check-api-b3c430e7/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)
