# Contract Renewal Audit

> Contract Renewal Audit is a paid API for AI agents from rooke-token-risk-pilot.rookepoole.workers.dev, paid per call via x402, $9/call, status unknown (last checked 2026-09-14).

Audits a SaaS or vendor contract renewal proposal against committed contract terms, pricing escalation caps, utilization data, and notice-window deadlines to produce a structured verdict and risk flags.

## Facts

- Endpoint: POST https://rooke-token-risk-pilot.rookepoole.workers.dev/v1/x402/contract-renewal-audit
- Price: $9/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/contract-renewal-audit-30cfa88e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_q6sgl1iN30UKwMEU_c8Dk

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 contract-renewal-audit-30cfa88e -d '<json body>'
```

Example prompt: Audit the renewal proposal RENEWAL-42 for contract SaaS-42 (version signed-2026) from VENDOR-9 — the current term runs 2026-01-01 to 2026-12-31 with 100 licensed-seats committed at 1000 USD-cents each and a fixed fee of 10000 cents, escalation caps of 500 bps on unit price and 500 bps on fixed fee, a 90-day notice window, auto-renew mode, and the vendor is proposing 88 seats at 1050 cents with a 10500-cent fixed fee for a 12-month renewal starting 2027-01-01 — tell me if the pricing matches within tolerance and whether we're still inside the notice window.

## When to prefer this

Use this endpoint when an AI agent or procurement workflow needs a structured, auditable ruling on whether a vendor's renewal proposal complies with signed contract terms — including escalation caps, committed unit counts, fixed fees, notice windows, and renewal dates — before any payment is authorized or renewal is accepted. Prefer this over manual review or generic contract parsing when you need a machine-readable verdict with risk flags and a report hash for downstream audit trails.

## Known failure modes

- Missing required contract fields returns a 400 validation error
- Invalid date format (not YYYY-MM-DD) causes schema rejection
- Escalation bps or price values exceeding schema maximums fail validation
- Mismatched currency codes between contract and proposal may produce unexpected variance
- Caller-supplied utilization data is not authenticated — evidence gap flag is always raised
- Payment failure (insufficient USDC balance) returns HTTP 402 before processing

## How this service works

Public static preview plus paid token controls, risk consensus, AI security, webhook reliability, developer security, schedule risk, decision analysis, API release compatibility, accounts-payable reconciliation, e-commerce return eligibility, SaaS subscription-proration, sales-commission reconciliation, parcel-charge reconciliation, SLA service-credit reconciliation, advertising spend-and-fee audit, contract-renewal audit, workforce timecard reconciliation, hotel booking-commission reconciliation, and warehouse cycle-count adjustment reconciliation products for autonomous agents.

## Output

A JSON object containing: a verdict string (e.g. MATCHED_WITHIN_TOLERANCE), a recommended disposition, itemized pricing comparison (expected vs proposed totals in minor currency units), renewal term date validation, notice window status with deadline date and days remaining, utilization analysis with recommended committed units, an array of risk flags (e.g. CURRENT_UNUSED_COMMITMENT_AT_PEAK), evidence gap warnings, a claim boundary object indicating whether any irreversible actions have occurred, and a SHA-256 report hash for audit traceability.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "contract": {
   "type": "object",
   "required": [
    "contractId",
    "contractVersion",
    "vendorId",
    "currency",
    "currentTermStartDate",
    "currentTermEndDate",
    "renewalMode",
    "noticeDaysBeforeEnd",
    "renewalTermMonths",
    "unitName",
    "currentCommittedUnits",
    "currentUnitPriceMinor",
    "currentFixedFeeMinor",
    "unitPriceEscalationBps",
    "fixedFeeEscalationBps",
    "maximumRenewalUnitPriceMinor",
    "maximumRenewalFixedFeeMinor",
    "minimumCommittedUnits",
    "expectedCreditsMinor"
   ],
   "properties": {
    "currency": {
     "type": "string",
     "pattern": "^[A-Z]{3}$"
    },
    "unitName": {
     "type": "string",
     "maxLength": 120,
     "minLength": 1
    },
    "vendorId": {
     "type": "string",
     "maxLength": 120,
     "minLength": 1
    },
    "contractId": {
     "type": "string",
     "maxLength": 120,
     "minLength": 1
    },
    "renewalMode": {
     "enum": [
      "AUTO_RENEW",
      "EXPIRES_UNLESS_RENEWED"
     ],
     "type": "string"
    },
    "contractVersion": {
     "type": "string",
     "maxLength": 120,
     "minLength": 1
    },
    "renewalTermMonths": {
     "type": "integer",
     "maximum": 120,
     "exclusiveMinimum": 0
    },
    "currentTermEndDate": {
     "type": "string",
     "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "noticeDaysBeforeEnd": {
     "type": "integer",
     "maximum": 730,
     "exclusiveMinimum": 0
    },
    "currentFixedFeeMinor": {
     "type": "integer",
     "maximum": 9007199254740991,
     "minimum": 0
    },
    "currentTermStartDate": {
     "type": "string",
     "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "expectedCreditsMinor": {
     "type": "integer",
     "maximum": 9007199254740991,
     "minimum": 0
    },
    "currentCommittedUnits": {
     "type": "integer",
     "maximum": 1000000000,
     "exclusiveMinimum": 0
    },
    "currentUnitPriceMinor": {
     "type": "integer",
     "maximum": 9007199254740991,
     "minimum": 0
    },
    "fixedFeeEscalationBps": {
     "type": "integer",
     "maximum": 100000,
     "minimum": 0
    },
    "minimumCommittedUnits": {
     "type": "integer",
     "maximum": 1000000000,
     "exclusiveMinimum": 0
    },
    "unitPriceEscalationBps": {
     "type": "integer",
     "maximum": 100000,
     "minimum": 0
    },
    "maximumRenewalFixedFeeMinor": {
     "anyOf": [
      {
       "type": "integer",
       "maximum": 9007199254740991,
   
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "pricing": {
   "proposedTotalMinor": 97900,
   "expectedFixedFeeMinor": 10500,
   "expectedUnitPriceMinor": 1050,
   "proposalTotalVarianceMinor": 0,
   "expectedTotalForProposedUnitsMinor": 97900
  },
  "verdict": "MATCHED_WITHIN_TOLERANCE",
  "contract": {
   "currency": "USD",
   "unitName": "licensed-seat",
   "vendorId": "VENDOR-9",
   "contractId": "SaaS-42",
   "renewalMode": "AUTO_RENEW",
   "contractVersion": "signed-2026"
  },
  "riskFlags": [
   "CURRENT_UNUSED_COMMITMENT_AT_PEAK"
  ],
  "proposalId": "RENEWAL-42",
  "reportHash": "sha256-hex",
  "renewalTerm": {
   "datesMatch": true,
   "expectedEndDate": "2027-12-31",
   "expectedStartDate": "2027-01-01"
  },
  "utilization": {
   "peakUsedUnits": 80,
   "proposedCommittedUnits": 88,
   "recommendedCommittedUnits": 88,
   "proposedCommitmentVarianceUnits": 0
  },
  "evidenceGaps": [
   "CALLER_SUPPLIED_CONTRACT_UTILIZATION_AND_PROPOSAL_FACTS_NOT_AUTHENTICATED"
  ],
  "noticeWindow": {
   "status": "OPEN",
   "noticeDeadlineDate": "2026-10-02",
   "daysUntilNoticeDeadline": 2
  },
  "claimBoundary": {
   "fundsMoved": false,
   "paymentAttempted": false,
   "noticeSentOrReceived": false,
   "vendorOrMarketplaceConnected": false,
   "contractRenewedCanceledOrAmended": false
  },
  "schemaVersion": "CONTRACT_RENEWAL_AUDIT_V1",
  "requestCommitment": "sha256-hex",
  "recommendedDisposition": "MATCHED_NO_ACTION"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/contract-renewal-audit-30cfa88e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from rooke-token-risk-pilot.rookepoole.workers.dev](https://www.zero.xyz/host/rooke-token-risk-pilot.rookepoole.workers.dev/llms.txt)
