{"openapi":"3.1.0","info":{"title":"People's Court x402 API","version":"1.0.0","description":"Fixed-price machine-readable dispute-readiness services.","contact":{"name":"People's Court","email":"contact@peoplescourt.ai"},"x-guidance":"Use POST /api/x402/dispute-readiness with the documented structured JSON body. An unpaid request returns an x402 v2 PAYMENT-REQUIRED challenge. A paid response is informational only and does not file a case or assess its merits."},"servers":[{"url":"https://peoplescourt.ai"}],"x-discovery":{"ownershipProofs":["0x444f220bb84c885672e26c71d0d69714c1c60d5cdc6590bf9904784288e4c51a5fdd264668e9cfe2bff345d74fd5c0cb6cddf957b4726da8eb52d57140fcd0461b"]},"paths":{"/api/x402/dispute-readiness":{"post":{"operationId":"getDisputeReadiness","summary":"Get a deterministic dispute-readiness report","description":"Returns the supported lane, likely composition, published filing-fee quote, missing consent and evidence requirements, corpus compatibility, and timing warnings. This endpoint does not file a case, assess the merits, provide legal advice, or move disputed funds.","tags":["Dispute readiness"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"caseTrack":{"type":"string","enum":["ai_fast","ai_standard","ai_assisted_human"],"description":"Proposed track only; omitted leaves composition and filing fee unselected."},"claimantType":{"type":"string","enum":["human","organization","ai_agent"],"description":"Claimant party category."},"respondentType":{"type":"string","enum":["human","organization","ai_agent"],"description":"Respondent party category."},"amountInDisputeUsd":{"type":"number","minimum":0,"maximum":10000000,"description":"Amount in dispute in USD."},"remedy":{"type":"string","enum":["corpus_allocation","money_obligation","declaratory"],"description":"Requested remedy shape."},"settlementRail":{"type":"string","enum":["none","x402r","bilateral_escrow","acp","stripe_connect","partner_executes"],"description":"Existing or proposed settlement rail."},"fastTrackClaimClass":{"oneOf":[{"type":"string","enum":["payment_not_settled","refund_window_expired","non_delivery","double_charge","escrowed_refund_request","acp_evaluation"]},{"type":"null"}],"description":"Protocol-derived fast-track class, or null for an ordinary claim."},"mutualConsentReported":{"type":"boolean","description":"Whether bilateral arbitration consent is reported."},"authorityToBindReported":{"type":"boolean","description":"Whether signers report authority to bind their principals."},"claimantEvidenceReady":{"type":"boolean","description":"Whether claimant evidence is ready for filing."},"respondentEvidenceReady":{"type":"boolean","description":"Whether respondent evidence is expected to be available."},"microClaimsTierConsentReported":{"type":"boolean","description":"Whether both parties report consent to the micro-claims tier."},"remedialJurisdictionOptInReported":{"type":"boolean","description":"Whether both parties report consent to relief beyond a held corpus."},"corpusAmountUsd":{"oneOf":[{"type":"number","minimum":0,"maximum":10000000},{"type":"null"}],"description":"Bound external corpus in USD, or null when no corpus exists."},"escrowWindowEndsAt":{"type":"string","format":"date-time","description":"Optional settlement deadline in ISO 8601 form."}},"required":["claimantType","respondentType","amountInDisputeUsd","remedy","settlementRail","fastTrackClaimClass","mutualConsentReported","authorityToBindReported","claimantEvidenceReady","respondentEvidenceReady","microClaimsTierConsentReported","remedialJurisdictionOptInReported","corpusAmountUsd"]},"example":{"caseTrack":"ai_standard","claimantType":"ai_agent","respondentType":"ai_agent","amountInDisputeUsd":20,"remedy":"corpus_allocation","settlementRail":"x402r","fastTrackClaimClass":"non_delivery","mutualConsentReported":true,"authorityToBindReported":true,"claimantEvidenceReady":true,"respondentEvidenceReady":true,"microClaimsTierConsentReported":true,"remedialJurisdictionOptInReported":false,"corpusAmountUsd":20,"escrowWindowEndsAt":"2026-07-25T12:00:00.000Z"}}}},"responses":{"200":{"description":"The paid deterministic readiness report.","headers":{"PAYMENT-RESPONSE":{"description":"Base64-encoded x402 v2 settlement response.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"data":{"type":"object","additionalProperties":false,"properties":{"supportedLane":{"type":"boolean"},"readyToFile":{"type":"boolean"},"lane":{"type":"string","enum":["agent","standard"]},"composition":{"type":["object","null"],"properties":{"value":{"type":"string","enum":["memorandum","single_arbiter","panel"]},"reason":{"type":"string"}},"required":["value","reason"]},"filingFee":{"type":["object","null"],"properties":{"currency":{"type":"string","const":"USD"},"amountUsd":{"type":"number"},"tier":{"type":"string","enum":["micro","single_arbiter","panel","declaratory"]},"percent":{"type":"number"},"floorUsd":{"type":"number"},"panelSurchargeUsd":{"type":"number"},"collectionNote":{"type":"string"}},"required":["currency","amountUsd","tier","percent","floorUsd","panelSurchargeUsd","collectionNote"]},"requirements":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"satisfied":{"type":"boolean"},"detail":{"type":"string"}},"required":["code","satisfied","detail"]}},"corpusCompatibility":{"type":"object","properties":{"compatible":{"type":"boolean"},"detail":{"type":"string"}},"required":["compatible","detail"]},"timing":{"type":"object","properties":{"escrowWindowEndsAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"warning":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["escrowWindowEndsAt","warning"]},"disclaimers":{"type":"object","properties":{"caseFiled":{"type":"boolean","const":false},"meritsAssessed":{"type":"boolean","const":false},"legalAdvice":{"type":"boolean","const":false},"reportedFactsVerified":{"type":"boolean","const":false},"statement":{"type":"string"}},"required":["caseFiled","meritsAssessed","legalAdvice","reportedFactsVerified","statement"]}},"required":["supportedLane","readyToFile","lane","composition","filingFee","requirements","corpusCompatibility","timing","disclaimers"]},"payment":{"type":"object","properties":{"protocol":{"type":"string","const":"x402"},"priceUsd":{"type":"string","const":"0.010000"},"network":{"type":"string"},"transaction":{"type":"string"},"replayed":{"type":"boolean"}},"required":["protocol","priceUsd","replayed"]}},"required":["ok","data","payment"]},"example":{"ok":true,"data":{"supportedLane":false,"readyToFile":false,"lane":"agent","composition":{"value":"panel","reason":"party_elected_ai_standard"},"filingFee":{"currency":"USD","amountUsd":1,"tier":"panel","percent":5,"floorUsd":1,"panelSurchargeUsd":0,"collectionNote":"Proposed filing fee, separate from this $0.01 report; no consent or admission."},"requirements":[{"code":"case_track_election","satisfied":false,"detail":"Both parties must accept exact track terms. Legacy x402r/ACP referrals cannot bind them."},{"code":"bilateral_consent","satisfied":true,"detail":"Both parties must provide case-bound consent under the published Rules before merits review."},{"code":"authority_to_bind","satisfied":true,"detail":"Each person or agent acting for a principal must establish authority to bind that principal."},{"code":"claimant_evidence","satisfied":true,"detail":"The claimant must be able to identify and submit the evidence supporting the claim."},{"code":"respondent_process","satisfied":true,"detail":"The respondent must receive process and an opportunity to answer and submit evidence."},{"code":"remedy_scope","satisfied":true,"detail":"The requested relief is limited to the reported external corpus."}],"corpusCompatibility":{"compatible":true,"detail":"The requested relief is limited to the reported external corpus."},"timing":{"escrowWindowEndsAt":"2026-07-25T12:00:00.000Z","warning":null},"disclaimers":{"caseFiled":false,"meritsAssessed":false,"legalAdvice":false,"reportedFactsVerified":false,"statement":"This automated report checks structured technical readiness only. It does not file a case, verify the reported facts, assess the merits, or provide legal advice."}},"payment":{"protocol":"x402","priceUsd":"0.010000","network":"eip155:84532","transaction":"0x1212121212121212121212121212121212121212121212121212121212121212","replayed":false}}}}},"400":{"description":"Invalid structured request body."},"402":{"description":"Payment required. Read PAYMENT-REQUIRED, sign one advertised option, and retry with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements with Bazaar discovery metadata.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","const":2},"error":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}},"required":["x402Version","resource","accepts","extensions"]}}}},"409":{"description":"Payment replay is in progress or conflicts with the original request."},"413":{"description":"Request body exceeds the resource-specific size limit."},"429":{"description":"Per-caller or global settlement cap reached."},"503":{"description":"Resource disabled, unavailable, or awaiting payment reconciliation."}}}}}}