{"uid":"cap_q6sgl1iN30UKwMEU_c8Dk","slug":"contract-renewal-audit-30cfa88e","name":"Contract Renewal Audit","description":"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.","url":"https://rooke-token-risk-pilot.rookepoole.workers.dev/v1/x402/contract-renewal-audit","method":"POST","headers":{},"bodySchema":{"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,"minimum":0},{"type":"null"}]},"maximumRenewalUnitPriceMinor":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":0},{"type":"null"}]}},"additionalProperties":false},"proposal":{"type":"object","required":["proposalId","renewalStartDate","renewalEndDate","committedUnits","unitPriceMinor","fixedFeeMinor","creditsMinor","totalMinor"],"properties":{"proposalId":{"type":"string","maxLength":120,"minLength":1},"totalMinor":{"type":"integer","maximum":9007199254740991,"minimum":0},"creditsMinor":{"type":"integer","maximum":9007199254740991,"minimum":0},"fixedFeeMinor":{"type":"integer","maximum":9007199254740991,"minimum":0},"committedUnits":{"type":"integer","maximum":1000000000,"exclusiveMinimum":0},"renewalEndDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"unitPriceMinor":{"type":"integer","maximum":9007199254740991,"minimum":0},"renewalStartDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"additionalProperties":false},"auditPolicy":{"type":"object","required":["evaluatedAtDate","utilizationHeadroomBps","amountToleranceMinor"],"properties":{"evaluatedAtDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"amountToleranceMinor":{"type":"integer","maximum":1000000,"minimum":0},"utilizationHeadroomBps":{"type":"integer","maximum":100000,"minimum":0}},"additionalProperties":false},"utilization":{"type":"object","required":["lookbackStartDate","snapshots"],"properties":{"snapshots":{"type":"array","items":{"type":"object","required":["observedAtDate","usedUnits"],"properties":{"usedUnits":{"type":"integer","maximum":1000000000,"minimum":0},"observedAtDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"additionalProperties":false},"maxItems":1000,"minItems":1},"lookbackStartDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"additionalProperties":false}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"9","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$9/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"9","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"9","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0e5I-mr9tMZ_TZrleUelq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"9","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"SaaS renewal pricing compliance check","prompt":"We have a renewal proposal from our CRM vendor for next year — contract ID ENT-CRM-01 version v2, vendor VENDOR-SALESFORCE, current term 2025-01-01 to 2025-12-31, 500 licensed-seats at 8000 cents each, fixed fee 500000 cents, unit price escalation cap 300 bps, fixed fee escalation cap 200 bps, max unit price 8240 cents, 60-day notice required, auto-renew, 12-month renewal term, minimum 400 seats, no expected credits, peak usage was 480 seats — they're proposing 500 seats at 8240 cents and fixed fee 510000 cents starting 2026-01-01. Does this match the contract terms?"},{"title":"Notice deadline urgency check before auto-renew","prompt":"Check contract AUTO-CLOUD-7 version 2024-signed from VENDOR-AZURE — current term 2025-03-01 to 2025-08-31, 200 compute-units committed at 50000 cents, no fixed fee, 0 bps escalation, 45-day notice window, AUTO_RENEW mode, 12-month renewal, minimum 100 units, no credits — the vendor proposed renewing 200 units at 50000 cents starting 2025-09-01. Are we still inside the notice window or have we missed the deadline to cancel?"},{"title":"Over-commitment risk flag before renewal approval","prompt":"Before I approve this renewal, audit contract SAAS-HR-99 version v3 from VENDOR-WORKDAY — current term 2024-07-01 to 2025-06-30, we committed to 1000 employee-seats at 2000 cents each with no fixed fee, 400 bps unit price escalation cap, max renewal price 2080 cents, 90-day notice, EXPIRES_UNLESS_RENEWED, 12-month term, minimum 500 seats, no credits, and peak usage only hit 600 seats — the proposal is for 1000 seats at 2080 cents from 2025-07-01 to 2026-06-30. Flag any risk around over-commitment given our actual utilization."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:42:42.801Z","isFirstParty":false}