# BRAINIAC Document Signature Coverage Check

> BRAINIAC Document Signature Coverage Check is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.03/call, status unknown (last checked 2026-11-12).

Analyzes PDF documents and associated cryptographic metadata to determine how much of each document's byte content is covered by digital signatures, detecting gaps and reporting signature field coverage ratios.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/document-trust/signature-coverage-check?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-document-signature-coverage-check-befe16dc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_On_w8euF3s2peP0iDCOge

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-document-signature-coverage-check-befe16dc -d '<json body>'
```

Example prompt: Can you check how much of this signed contract PDF is actually covered by its digital signatures — I want to know the coverage ratio, any uncovered byte ranges, and whether any signature fields are missing? I'll attach the PDF and the signer certificates.

## When to prefer this

Use this endpoint when you need to programmatically verify the byte-range coverage of digital signatures in PDF documents without requiring a third-party e-signature platform account or API key. It is ideal for compliance pipelines, legal document audits, and agent workflows where you need objective, local cryptographic analysis of signature coverage. It does not make live certificate revocation queries, so pair it with an OCSP/CRL service if live revocation status matters.

## Known failure modes

- Oversized PDF base64 exceeding 12MB field limit returns a validation error
- Missing required fileBase64 field causes a 400 bad request
- Certificates not in valid PEM format may cause parsing errors
- Revocation checking is only against caller-supplied entries — not live OCSP/CRL, so revoked certs may not be flagged
- Cryptographic digest verification only reported when detached signature and expected hash are supplied; missing CMS fields are not invented
- No coverage found results in a 'no_coverage' finding rather than an error

## 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 JSON object with per-document items listing: filename, file size, covered bytes, coverage ratio (0–1), page count hint, signature field count, and flags for commercial platform use and legal enforceability claims. Also includes a list of findings (each with a code, kind, detail, and subject), a checkedAt timestamp, file count, and a limitations array explaining what was and was not verified (e.g. no live OCSP/CRL queries, cryptographic verification only when detached signature and public key are supplied).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "asOf": {
   "type": "string",
   "maxLength": 40
  },
  "json": {
   "type": "string",
   "maxLength": 200000
  },
  "text": {
   "type": "string",
   "maxLength": 200000
  },
  "files": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "fileBase64"
    ],
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "role": {
      "type": "string",
      "maxLength": 80
     },
     "filename": {
      "type": "string",
      "maxLength": 180,
      "minLength": 1
     },
     "mediaType": {
      "enum": [
       "application/pdf",
       "application/octet-stream"
      ],
      "type": "string"
     },
     "fileBase64": {
      "type": "string",
      "maxLength": 12000000,
      "minLength": 1
     },
     "versionLabel": {
      "type": "string",
      "maxLength": 80
     },
     "expectedSha256": {
      "type": "string",
      "maxLength": 128
     },
     "expectedByteRangeSha256": {
      "type": "string",
      "maxLength": 128
     }
    },
    "additionalProperties": false
   },
   "maxItems": 20
  },
  "signers": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "name": {
      "type": "string",
      "maxLength": 200
     },
     "email": {
      "type": "string",
      "maxLength": 200
     },
     "signedAt": {
      "type": "string",
      "maxLength": 40
     },
     "fieldName": {
      "type": "string",
      "maxLength": 120
     },
     "documentId": {
      "type": "string",
      "maxLength": 80
     },
     "certificateId": {
      "type": "string",
      "maxLength": 80
     }
    },
    "additionalProperties": false
   },
   "maxItems": 40
  },
  "revocations": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "reason": {
      "type": "string",
      "maxLength": 200
     },
     "source": {
      "type": "string",
      "maxLength": 200
     },
     "revokedAt": {
      "type": "string",
      "maxLength": 40
     },
     "serialNumber": {
      "type": "string",
      "maxLength": 128
     }
    },
    "additionalProperties": false
   },
   "maxItems": 200
  },
  "certificates": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "pem"
    ],
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "pem": {
      "type": "string"
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "id": "DOC-1",
    "size": 872,
    "fields": [],
    "filename": "contract-v1.pdf",
    "coveredBytes": 0,
    "coverageRatio": 0,
    "pageCountHint": 0,
    "signatureFieldCount": 0,
    "commercialPlatformUsed": false,
    "legalEnforceabilityClaimed": false
   }
  ],
  "status": "checked",
  "findings": [
   {
    "code": "no_coverage",
    "kind": "observation",
    "detail": "No signature ByteRange coverage was found.",
    "subject": "DOC-1"
   }
  ],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "fileCount": 1,
  "limitations": [
   "PDF bytes, certificates, signers, revocations, and detached signatures are processed only locally in this request path.",
   "No commercial electronic-signature platform is used and no API key is required.",
   "Technical signature, hash, certificate, and timestamp checks are not a determination of legal enforceability.",
   "Full CMS/PKCS#7 cryptographic verification is reported only when a detached signature and public key are supplied, or when ByteRange digests match caller-supplied expectations. Missing CMS fields are not invented.",
   "Revocation is evaluated only against caller-supplied revocation entries. Live commercial OCSP/CRL networks are not queried."
  ],
  "apiKeyRequired": false,
  "paidProviderUsed": false,
  "commercialPlatformUsed": false,
  "legalEnforceabilityClaimed": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-document-signature-coverage-check-befe16dc/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)
