# BRAINIAC Pagination Contract Check

> BRAINIAC Pagination Contract 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 spec or workflow definition to detect pagination anti-patterns that would cause AI agents to miss pages, loop infinitely, or skip records

## Facts

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

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-pagination-contract-check-fb708f28 -d '<json body>'
```

Example prompt: Can you check my OpenAPI spec for pagination issues that would confuse an AI agent — I have a /orders endpoint that uses a cursor parameter and I want to make sure the continuation field, termination condition, and first-page behavior are all clearly described?

## When to prefer this

Use this endpoint when you need automated, agent-readable feedback on whether your API contract is safe for AI agents to paginate through — particularly when you suspect missing continuation fields, unclear termination conditions, or conflicting cursor/offset styles. Prefer it over manual review when building agent pipelines that call list endpoints, or before deploying an agent that must traverse multi-page results without human supervision.

## Known failure modes

- Malformed or missing OpenAPI object returns a validation error
- Operations array exceeding 20 steps per item may be truncated
- No pagination-related operations found results in zero issues but low score
- Ambiguous schema references not resolvable without URL fetching are flagged in limitations
- Overly large input payloads may be rejected or truncated

## 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

A JSON object containing a numeric score (0-100), a boolean success flag, an analysis summary string, a list of issues each with type, severity, location, evidence, description, agent_impact, and suggested_fix fields, plus a warnings array and limitations list explaining what was and was not checked.

## 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": 48,
  "issues": [
   {
    "type": "missing_continuation",
    "evidence": "cursor",
    "location": "openapi.paths[/orders].get",
    "severity": "high",
    "description": "The contract describes a page or a cursor and does not name the response field that leads to the next page.",
    "agent_impact": "An agent can stop after the first page or loop because it has no declared continuation field.",
    "suggested_fix": "Name the response field, such as next_cursor, and the request field that receives it."
   },
   {
    "type": "unclear_cursor",
    "evidence": "Page cursor.",
    "location": "openapi.paths[/orders].get.parameters.cursor",
    "severity": "medium",
    "description": "A cursor parameter is named, and the text does not say whether it is opaque, how the first page is requested, or when it expires.",
    "agent_impact": "An agent may parse the cursor, omit it incorrectly, or reuse it after it stops working.",
    "suggested_fix": "Say to omit it for the first page, whether it is opaque, and whether it expires."
   },
   {
    "type": "unclear_termination",
    "evidence": "list_orders",
    "location": "openapi.paths[/orders].get",
    "severity": "high",
    "description": "The contract does not say how the agent knows the last page has been reached.",
    "agent_impact": "An agent can keep requesting pages after the list has ended.",
    "suggested_fix": "State the end condition, such as a null next cursor, has_more false, or an empty page."
   },
   {
    "type": "conflicting_pagination",
    "evidence": "cursor, offset",
    "location": "openapi.paths[/orders].get",
    "severity": "medium",
    "description": "Both a cursor and an offset or page parameter are declared, and the text does not say which one to follow.",
    "agent_impact": "An agent can send both and skip or repeat records.",
    "suggested_fix": "Tell the agent to use one continuation style and ignore the other."
   }
  ],
  "success": true,
  "analysis": "Checked 1 operations that mention a page, cursor, or offset.",
  "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 tha
… (truncated)
```

## More

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