# BRAINIAC Agent Contract Expiry Check

> BRAINIAC Agent Contract Expiry 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 an OpenAPI contract, operations, and workflows to detect missing or contradictory expiry documentation for temporary URLs, tokens, and credentials

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/agent-contracts/expiry-contract-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-agent-contract-expiry-check-997a1b0b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FwkMFhaXer2RWpdBj6x5z

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-agent-contract-expiry-check-997a1b0b -d '<json body>'
```

Example prompt: Can you check my OpenAPI contract and these operations for any missing or contradictory expiry documentation on temporary URLs and access tokens — I need a compliance score and a list of any issues found?

## When to prefer this

Use this endpoint when you need a lightweight, deterministic, pay-per-call audit of an API contract's expiry documentation quality — specifically to catch missing lifetimes or contradictory expiry statements before deploying an AI agent that will call the API. Prefer this over manual review when you need a machine-readable score and structured issue list. It is not a substitute for runtime testing or dynamic security scanning.

## Known failure modes

- Malformed or missing OpenAPI/operations input returns a validation error
- Truncated or very large schemas may exceed processing limits
- The checker only reads supplied text — it does not fetch live URLs or validate running implementations
- Fixed-phrase matching may miss custom or unusual naming conventions for temporary tokens
- No network errors expected since no external URLs are fetched

## 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 containing a numeric compliance score (0-100), a boolean success flag, an analysis summary string, an array of issues each with type, severity (high/medium/low), location path, evidence text, description, agent_impact, and suggested_fix, plus warnings and limitations arrays explaining what the checker can and cannot determine.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "openapi": {
   "type": "object",
   "propertyNames": {
    "type": "string",
    "maxLength": 80
   },
   "additionalProperties": {}
  },
  "workflows": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "name"
    ],
    "properties": {
     "name": {
      "type": "string",
      "maxLength": 160,
      "minLength": 1
     },
     "steps": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "name"
       ],
       "properties": {
        "name": {
         "type": "string",
         "maxLength": 160,
         "minLength": 1
        },
        "operation": {
         "type": "string",
         "maxLength": 160
        },
        "description": {
         "type": "string",
         "maxLength": 4000
        }
       },
       "additionalProperties": false
      },
      "maxItems": 30
     },
     "states": {
      "type": "array",
      "items": {
       "type": "string",
       "maxLength": 80,
       "minLength": 1
      },
      "maxItems": 40
     },
     "description": {
      "type": "string",
      "maxLength": 8000
     },
     "transitions": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "from",
        "to"
       ],
       "properties": {
        "on": {
         "type": "string",
         "maxLength": 200
        },
        "to": {
         "type": "string",
         "maxLength": 80,
         "minLength": 1
        },
        "from": {
         "type": "string",
         "maxLength": 80,
         "minLength": 1
        },
        "operation": {
         "type": "string",
         "maxLength": 160
        }
       },
       "additionalProperties": false
      },
      "maxItems": 80
     }
    },
    "additionalProperties": false
   },
   "maxItems": 12
  },
  "operations": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "name"
    ],
    "properties": {
     "name": {
      "type": "string",
      "maxLength": 160,
      "minLength": 1
     },
     "path": {
      "type": "string",
      "maxLength": 400
     },
     "steps": {
      "type": "array",
      "items": {
       "type": "string",
       "maxLength": 200,
       "minLength": 1
      },
      "maxItems": 20
     },
     "method": {
      "type": "string",
      "maxLength": 16
     },
     "summary": {
      "type": "string",
      "maxLength": 1000
     },
     "examples": {
      "type": 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "score": 55,
  "issues": [
   {
    "type": "missing_expiry",
    "evidence": "upload_url",
    "location": "operations[0].outputSchema.properties.upload_url",
    "severity": "high",
    "description": "A temporary URL or token is named, and neither the field nor the operation states when it stops being valid. The lifetime is undocumented, not observed.",
    "agent_impact": "An agent may call the URL after it has stopped working, or it may refresh a value that the contract never says to refresh.",
    "suggested_fix": "State the lifetime, such as expires in 15 minutes, or name an expires_at field."
   },
   {
    "type": "contradictory_expiry",
    "evidence": "The access token never expires. It expires in 5 minutes.",
    "location": "operations[1]",
    "severity": "high",
    "description": "The same description both gives a lifetime and says the value does not expire. These are conflicting sentences in the contract.",
    "agent_impact": "An agent cannot decide whether to refresh the URL or token before using it.",
    "suggested_fix": "Keep one statement: a lifetime, or an explicit statement that it does not expire."
   }
  ],
  "success": true,
  "analysis": "Checked 2 operations that name a temporary URL or token.",
  "warnings": [],
  "limitations": [
   "Checks read only the supplied operations, workflows, and OpenAPI document. No URL is fetched and no model reads the text.",
   "A missing sentence is an undocumented contract. It is not a confirmed defect in a running implementation.",
   "A contradiction is two statements in the supplied text. It is not proof of how a server behaves.",
   "The HTTP method is not evidence that an operation is safe to retry or that it is idempotent.",
   "Matches are fixed phrases and field names. They do not infer a business rule that the text does not state.",
   "Temporary names are presigned or signed URLs, upload and download URLs, access, refresh, and session tokens, and one-time codes. A bare url or token is not enough.",
   "A sibling expires, expiry, or ttl field counts as documented lifetime. Each missing lifetime subtracts 20. A contradiction subtracts 25.",
   "The score is omitted when the document names no temporary resource."
  ],
  "recommendations": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-agent-contract-expiry-check-997a1b0b/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)
