{ "openapi": "3.1.0", "info": { "title": "People’s Court Headless Partner API", "version": "2.0.0", "summary": "Integrate bilateral disputes, narrow evaluations, evidence, decisions, callbacks, and authorized settlement workflows.", "description": "Use role-bound credentials and the current resource state to create cases, represent an authorized party, build an immutable record, receive a served decision, and perform separately authorized settlement operations." }, "servers": [ { "url": "https://peoplescourt.ai" } ], "tags": [ { "name": "Discovery", "description": "Read the current Rules and quote filing fees before opening a case.", "x-status": "live" }, { "name": "Cases and drafts", "description": "Immutable preparation and tenant-scoped case state.", "x-status": "live" }, { "name": "AP2 Resolution Bridge", "description": "Feature-gated AP2 evidence verification and bilateral resolution intake over existing case, Award, finality, and execution resources.", "x-status": "partial" }, { "name": "UCP Resolution Adapter", "description": "Feature-gated UCP Order verification and bilateral resolution intake over the same existing case, Award, finality, and execution resources.", "x-status": "partial" }, { "name": "Participants invitations and authority", "description": "Side memberships, confirmation, and respondent handoff.", "x-status": "live" }, { "name": "Claims answers and submissions", "description": "Pleadings and stage-bound party filings.", "x-status": "live" }, { "name": "Case termination", "description": "Claimant withdrawal before the Answer and independently confirmed termination after the Answer.", "x-status": "live" }, { "name": "Evidence and challenges", "description": "Exchange signed evidence exports, adopt verified candidates, and challenge revealed opposing evidence without automatic exclusion.", "x-status": "live" }, { "name": "Messages", "description": "Immutable non-merits procedural messages with evidence-system references.", "x-status": "live" }, { "name": "Record confirmation", "description": "Own-side restatement review and immutable final record confirmation.", "x-status": "live" }, { "name": "Narrow evaluations", "description": "Jointly authorized bounded questions over a confirmed two-sided record.", "x-status": "live" }, { "name": "Decisions and finality", "description": "Served Awards, artifacts, decision finality, and record manifests.", "x-status": "live" }, { "name": "Settlement", "description": "Digest-bound settlement registration, validation, execution receipts, and decision status.", "x-status": "live" }, { "name": "Webhooks", "description": "Durable at-least-once callbacks with self-service rotation, inspection, replay, and dead-letter operations.", "x-status": "live" } ], "paths": { "/api/v2/integration": { "get": { "security": [ { "platformOrchestratorBearer": [] }, { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] }, { "evidenceExporterBearer": [] }, { "settlementAdapterBearer": [] }, { "readOnlyObserverBearer": [] } ], "tags": [ "Discovery" ], "operationId": "getIntegrationIdentityV2", "summary": "Verify a credential and inspect its tenant role and capabilities", "responses": { "200": { "description": "Authenticated integration identity and public credential metadata.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PartnerIntegrationIdentityEnvelope" } } } }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/rules/current": { "get": { "security": [], "tags": [ "Discovery" ], "operationId": "getCurrentRulesV2", "summary": "Read the current Rules and public procedure metadata", "responses": { "200": { "$ref": "#/components/responses/Data" }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/fees/quote": { "post": { "security": [], "tags": [ "Discovery" ], "operationId": "quoteFilingFeeV2", "summary": "Quote the filing fee for a proposed claim", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "claimAmount" ], "properties": { "claimAmount": { "$ref": "#/components/schemas/FiatMoney" }, "declaratoryOnly": { "type": "boolean" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/Data" }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/ap2/resolution-requests": { "post": { "security": [ { "platformOrchestratorBearer": [] } ], "tags": [ "AP2 Resolution Bridge" ], "operationId": "createAp2ResolutionRequestV1", "summary": "Verify an AP2 package and open an existing bilateral evaluation case", "description": "AP2 purchase authority is evidence only. A case opens only after the separate resolution-authorization-v1 artifact carries valid claimant and respondent signatures.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ap2ResolutionRequestV1" } } } }, "responses": { "201": { "$ref": "#/components/responses/Ap2ResolutionCase" }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/ap2/resolution-results/{caseId}": { "get": { "security": [ { "platformOrchestratorBearer": [] }, { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] }, { "readOnlyObserverBearer": [] } ], "tags": [ "AP2 Resolution Bridge" ], "operationId": "getAp2ResolutionResultV1", "summary": "Project the existing Award finality authorized remedy and execution confirmation", "parameters": [ { "$ref": "#/components/parameters/CaseId" } ], "responses": { "200": { "$ref": "#/components/responses/ResolutionResult" }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/ucp/resolution-requests": { "post": { "security": [ { "platformOrchestratorBearer": [] } ], "tags": [ "UCP Resolution Adapter" ], "operationId": "createUcpResolutionRequestV1", "summary": "Verify a signed UCP Order and open an existing bilateral evaluation case", "description": "The UCP Order is transaction evidence only. A case opens only after the separate resolution-authorization-v1 artifact carries valid claimant and respondent signatures and exactly matches the neutral handoff.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UcpResolutionRequestV1" } } } }, "responses": { "201": { "$ref": "#/components/responses/UcpResolutionCase" }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/ucp/resolution-results/{caseId}": { "get": { "security": [ { "platformOrchestratorBearer": [] }, { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] }, { "readOnlyObserverBearer": [] } ], "tags": [ "UCP Resolution Adapter" ], "operationId": "getUcpResolutionResultV1", "summary": "Project the existing Award finality authorized remedy and execution confirmation", "parameters": [ { "$ref": "#/components/parameters/CaseId" } ], "responses": { "200": { "$ref": "#/components/responses/ResolutionResult" }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/filings/prepare": { "post": { "security": [ { "platformOrchestratorBearer": [] }, { "claimantAgentBearer": [] } ], "tags": [ "Cases and drafts" ], "operationId": "prepareFilingV2", "summary": "Prepare a claimant filing draft", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PrepareFiling" } } } }, "responses": { "201": { "$ref": "#/components/responses/Data" }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/filings/{draftId}/confirm": { "post": { "security": [ { "platformOrchestratorBearer": [] }, { "claimantAgentBearer": [] } ], "tags": [ "Cases and drafts" ], "operationId": "confirmFilingV2", "summary": "Confirm and open a prepared claimant filing", "parameters": [ { "$ref": "#/components/parameters/DraftId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FilingConfirmation" } } } }, "responses": { "201": { "$ref": "#/components/responses/Data" }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/case-drafts": { "post": { "security": [ { "platformOrchestratorBearer": [] }, { "claimantAgentBearer": [] } ], "tags": [ "Cases and drafts" ], "operationId": "createCaseDraftV2", "summary": "Create a configurable case draft", "description": "Creates a case draft for the selected intake and confirmation policy. In claimant_initiated mode the claimant may omit respondent consent; the case opens awaiting a human respondent who accepts through the show-once hosted login path. Every other mode remains bilaterally authorized.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateCaseDraft" } } } }, "responses": { "201": { "$ref": "#/components/responses/Data" }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/authorizations/authority-grants": { "post": { "security": [ { "claimantAgentBearer": [] } ], "tags": [ "Participants invitations and authority" ], "operationId": "registerClaimantAuthorityV2", "summary": "Record a claimant-agent authority assertion and artifact hashes", "description": "Records which authenticated claimant-agent credential made the assertion plus the supplied artifact references and hashes. This endpoint does not retrieve the artifacts or cryptographically verify an underlying principal signature. A platform-orchestrator credential cannot make the assertion.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AuthorityGrantRegistration" } } } }, "responses": { "201": { "description": "The authenticated claimant-agent assertion was recorded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AuthorityGrantRegistrationEnvelope" } } } }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/authorizations/consents": { "post": { "security": [ { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] } ], "tags": [ "Participants invitations and authority" ], "operationId": "registerPartyConsentV2", "summary": "Record one party-agent consent assertion and artifact hash", "description": "Records which role-bound partner credential made the assertion and the supplied artifact reference and hash. The credential role must match the submitted party. This endpoint does not verify an underlying principal signature, email delivery, or artifact availability. Each side is a separate idempotent call.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConsentArtifactRegistration" } } } }, "responses": { "201": { "description": "The authenticated party-agent consent assertion was recorded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConsentArtifactRegistrationEnvelope" } } } }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/case-drafts/{draftId}": { "get": { "security": [ { "platformOrchestratorBearer": [] }, { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] } ], "tags": [ "Cases and drafts" ], "operationId": "getCaseDraftV2", "summary": "Read a case draft and its confirmation state", "parameters": [ { "$ref": "#/components/parameters/DraftId" } ], "responses": { "200": { "$ref": "#/components/responses/Data" }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/case-drafts/{draftId}/confirmations": { "post": { "security": [ { "platformOrchestratorBearer": [] }, { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] } ], "tags": [ "Participants invitations and authority" ], "operationId": "confirmCaseDraftParticipantV2", "summary": "Confirm one participant in a case draft", "description": "Records one participant confirmation. The last required confirmation atomically opens the case.", "parameters": [ { "$ref": "#/components/parameters/DraftId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CaseDraftConfirmation" } } } }, "responses": { "201": { "description": "The case opened. Initial capabilities are returned once and are omitted from idempotency replays.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfirmedCaseDraftEnvelope" } } } }, "202": { "description": "The confirmation was recorded, but another required participant confirmation is still pending.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CaseDraftResourceEnvelope" } } } }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/cases/{caseId}": { "get": { "security": [ { "platformOrchestratorBearer": [] }, { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] }, { "readOnlyObserverBearer": [] } ], "tags": [ "Cases and drafts" ], "operationId": "getCaseV2", "summary": "Read the current case projection", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "$ref": "#/components/parameters/PartyToken" } ], "responses": { "200": { "$ref": "#/components/responses/Data" }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/cases/{caseId}/respondent-handoff": { "post": { "security": [ { "platformOrchestratorBearer": [] } ], "tags": [ "Participants invitations and authority" ], "operationId": "issueRespondentHandoffV2", "summary": "Issue a show-once respondent handoff", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "201": { "description": "Show-once respondent invite plus the exact EIP-191 consent message the respondent wallet must sign. The message binds this public caseId and contains no internal dispute identifier.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "requestId" ], "properties": { "data": { "$ref": "#/components/schemas/RespondentHandoff" }, "requestId": { "type": "string" } } } } } }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/cases/{caseId}/participants": { "get": { "security": [ { "platformOrchestratorBearer": [] }, { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] } ], "tags": [ "Participants invitations and authority" ], "operationId": "getCaseParticipantsV2", "summary": "List confirmed case participants and authority", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "$ref": "#/components/parameters/PartyToken" } ], "responses": { "200": { "$ref": "#/components/responses/Data" }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/cases/{caseId}/answer": { "post": { "security": [ { "respondentAgentBearer": [] } ], "tags": [ "Claims answers and submissions" ], "operationId": "answerV2", "summary": "File the respondent Answer", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Answer" } } } }, "responses": { "201": { "$ref": "#/components/responses/Data" }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/cases/{caseId}/termination-requests": { "post": { "security": [ { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] } ], "tags": [ "Case termination" ], "operationId": "createOrCancelTerminationRequestV2", "summary": "Withdraw a pre-Answer claim or request termination without an Award", "description": "The acting side is derived from the role-bound credential and active case membership. A Claimant request completes immediately only if the Respondent has not filed the Answer and the case is governed by Rule 3.7. Otherwise both sides must independently confirm. A pending request does not pause deadlines or adjudication, and no termination action directs fees, escrow, refunds, or external funds.", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TerminationRequestInput" } } } }, "responses": { "200": { "description": "Existing request cancelled or replayed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PreAwardTerminationResponse" } } } }, "201": { "description": "Termination requested or completed by pre-Answer withdrawal", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PreAwardTerminationResponse" } } } }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/cases/{caseId}/termination-requests/{requestId}/confirmations": { "post": { "security": [ { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] } ], "tags": [ "Case termination" ], "operationId": "confirmTerminationRequestV2", "summary": "Independently confirm a pending termination request", "description": "Confirmation must come from the side that did not initiate the request, using a role-bound termination capability and an active case membership that expressly permits case termination.", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "name": "requestId", "in": "path", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "expectedRevision" ], "properties": { "expectedRevision": { "type": "integer", "minimum": 0 }, "adoption": { "$ref": "#/components/schemas/RulesAdoptionAssent" }, "externalProtocolReference": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,200}$" } } } } } }, "responses": { "200": { "description": "Counterparty confirmation committed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PreAwardTerminationResponse" } } } }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/cases/{caseId}/submissions": { "post": { "security": [ { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] } ], "tags": [ "Claims answers and submissions" ], "operationId": "submitPartyEvidenceV2", "summary": "Submit a stage-bound party brief and evidence", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "$ref": "#/components/parameters/Party" }, { "$ref": "#/components/parameters/PartyToken" } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "required": [ "party", "brief" ], "properties": { "party": { "type": "string", "enum": [ "claimant", "respondent" ] }, "brief": { "type": "string" }, "files": { "type": "array", "items": { "type": "string", "contentEncoding": "binary" } }, "evidenceCandidateRefs": { "type": "string", "description": "JSON array of exportRecordId and artifactRef objects." } } } } } }, "responses": { "201": { "$ref": "#/components/responses/Data" }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/cases/{caseId}/messages": { "get": { "security": [ { "platformOrchestratorBearer": [] }, { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] } ], "tags": [ "Messages" ], "operationId": "listProceduralMessagesV2", "summary": "List immutable shared procedural messages", "description": "Messages are ordered by creation time and ID. They are not part of, and do not mutate, the merits record.", "parameters": [ { "$ref": "#/components/parameters/CaseId" } ], "responses": { "200": { "description": "Case-scoped procedural messages.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "requestId" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "messages", "recordEffect" ], "properties": { "messages": { "type": "array", "items": { "$ref": "#/components/schemas/PartnerProceduralMessage" } }, "recordEffect": { "type": "string", "const": "none" } } }, "requestId": { "type": "string" } } } } } }, "default": { "$ref": "#/components/responses/Problem" } } }, "post": { "security": [ { "platformOrchestratorBearer": [] }, { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] } ], "tags": [ "Messages" ], "operationId": "createProceduralMessageV2", "summary": "Append an immutable non-merits procedural message", "description": "The acting side is derived from the credential and case membership. Platform orchestrators may issue procedural_notice only; party agents may use the other bounded categories. Evidence IDs are references to exchanged or admitted case evidence, never uploads or admissions. The immutable commit atomically enforces at most 20 messages per credential and case in a rolling hour.", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PartnerProceduralMessageInput" } } } }, "responses": { "201": { "description": "Immutable message, or the canonical idempotent replay.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "requestId" ], "properties": { "data": { "$ref": "#/components/schemas/PartnerProceduralMessage" }, "requestId": { "type": "string" } } } } } }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/cases/{caseId}/evidence-candidates": { "get": { "security": [ { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] } ], "tags": [ "Evidence and challenges" ], "operationId": "listEvidenceCandidatesV2", "summary": "List verified evidence export candidates", "description": "Lists verified candidate artifacts shared with this case. Source/export tenant and authenticated adopter tenant remain distinct; active case-side authorization controls visibility and adoption.", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "$ref": "#/components/parameters/PartyToken" } ], "responses": { "200": { "description": "Case-scoped evidence candidates visible to the acting side.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "requestId" ], "properties": { "data": { "$ref": "#/components/schemas/EvidenceCandidateList" }, "requestId": { "type": "string" } } } } } }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/cases/{caseId}/restatement": { "get": { "security": [ { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] } ], "tags": [ "Record confirmation" ], "operationId": "getRestatementV2", "summary": "Read the acting side's proposed record restatement", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "$ref": "#/components/parameters/PartyToken" } ], "responses": { "200": { "$ref": "#/components/responses/Data" }, "default": { "$ref": "#/components/responses/Problem" } } }, "post": { "security": [ { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] } ], "tags": [ "Record confirmation" ], "operationId": "respondToRestatementV2", "summary": "Confirm or correct the acting side's restatement", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "$ref": "#/components/parameters/Party" }, { "$ref": "#/components/parameters/PartyToken" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "action" ], "properties": { "action": { "type": "string", "enum": [ "confirm", "correct" ] }, "correction": { "type": "string", "maxLength": 4000 } } } } } }, "responses": { "200": { "$ref": "#/components/responses/Data" }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/cases/{caseId}/record-confirmations": { "get": { "security": [ { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] } ], "tags": [ "Record confirmation" ], "operationId": "getRecordConfirmationV2", "summary": "Read the acting side's record-confirmation state", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "$ref": "#/components/parameters/PartyToken" } ], "responses": { "200": { "$ref": "#/components/responses/Data" }, "default": { "$ref": "#/components/responses/Problem" } } }, "post": { "security": [ { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] } ], "tags": [ "Record confirmation" ], "operationId": "confirmRecordV2", "summary": "Confirm the acting side's immutable record digest", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "$ref": "#/components/parameters/Party" }, { "$ref": "#/components/parameters/PartyToken" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "recordDigest", "confirmationStatement" ], "properties": { "recordDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "confirmationStatement": { "type": "string" } } } } } }, "responses": { "200": { "$ref": "#/components/responses/Data" }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/cases/{caseId}/docket": { "get": { "security": [ { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] } ], "tags": [ "Cases and drafts" ], "operationId": "getDocketV2", "summary": "Read the case docket projection", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "$ref": "#/components/parameters/PartyToken" } ], "responses": { "200": { "$ref": "#/components/responses/Data" }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/cases/{caseId}/award": { "get": { "security": [ { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] } ], "tags": [ "Decisions and finality" ], "operationId": "getServedAwardV2", "summary": "Read the served Award", "description": "Returns the deterministic public decision projection derived from the immutable signed award-decision-v2 revision, never a mutable live disposition. It contains no internal dispute ID and no recipe-v3 manifest or verification envelope. Known internal IDs are replaced even when embedded in strings; every recognized money key must be numeric internally, null, or exact FiatMoney, every present amounts field must be an exact-money array, and malformed values or residual internal-ID patterns fail closed. companionArtifacts advertises PDF, DOCX, and canonical award-decision-v2 JSON descriptors through a closed-schema, separately signed, public-case-bound companion attestation.", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "$ref": "#/components/parameters/PartyToken" } ], "responses": { "200": { "$ref": "#/components/responses/Data" }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/cases/{caseId}/decision-status": { "get": { "security": [ { "platformOrchestratorBearer": [] }, { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] }, { "readOnlyObserverBearer": [] } ], "tags": [ "Decisions and finality", "Settlement" ], "operationId": "getDecisionStatusV2", "summary": "Read decision service, finality, and settlement status", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "$ref": "#/components/parameters/PartyToken" } ], "responses": { "200": { "$ref": "#/components/responses/Data" }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/cases/{caseId}/evaluation": { "get": { "security": [ { "platformOrchestratorBearer": [] }, { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] } ], "tags": [ "Narrow evaluations" ], "operationId": "getNarrowEvaluationV2", "summary": "Read the immutable evaluation definition and any served result", "description": "Returns pending or review state until an Award is served. A served result maps only to the three outcomes authorized in the evaluation draft.", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "$ref": "#/components/parameters/PartyToken" } ], "responses": { "200": { "description": "Narrow evaluation state and result projection.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "requestId" ], "properties": { "data": { "$ref": "#/components/schemas/NarrowEvaluationResource" }, "requestId": { "type": "string" } } } } } }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/cases/{caseId}/evaluation/accept": { "post": { "security": [ { "respondentAgentBearer": [] } ], "tags": [ "Narrow evaluations", "Participants invitations and authority" ], "operationId": "acceptNarrowEvaluationV2", "summary": "Accept a claimant-proposed narrow evaluation", "description": "Redeems the one-time respondent invitation and binds the respondent to the exact evaluation digest before evidence opens. Idempotency is resolved before mutable invitation/case-state validation: the same key and body replay the stored 201 without the show-once capability, while a different body returns idempotency_conflict.", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NarrowEvaluationAcceptanceInput" } } } }, "responses": { "201": { "description": "Evaluation accepted; the respondent party capability is returned once.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "requestId" ], "properties": { "data": { "$ref": "#/components/schemas/NarrowEvaluationAcceptance" }, "requestId": { "type": "string" } } } } } }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/cases/{caseId}/settlement-binding": { "post": { "security": [ { "platformOrchestratorBearer": [] } ], "tags": [ "Settlement" ], "operationId": "createSettlementBindingV2", "summary": "Bind a case to one external settlement corpus", "description": "A platform orchestrator registers the USD-only binding only after bilateral authorization and while the dispute is in awaiting_submissions or awaiting_validation, with no Award. The server atomically checks the current dispute revision/status, derives immutable actor and authority-grant metadata, and binds that metadata with the evaluation digest, action subset, participant identities, adapter, and corpus limits. An exact idempotent replay remains valid after the registration window closes.", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PartnerSettlementBindingInput" } } } }, "responses": { "201": { "description": "Immutable settlement binding created or idempotently replayed.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "requestId" ], "properties": { "data": { "$ref": "#/components/schemas/PartnerSettlementBinding" }, "requestId": { "type": "string" } } } } } }, "default": { "$ref": "#/components/responses/Problem" } } }, "get": { "security": [ { "platformOrchestratorBearer": [] }, { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] } ], "tags": [ "Settlement" ], "operationId": "getSettlementBindingV2", "summary": "Read the case's settlement binding", "parameters": [ { "$ref": "#/components/parameters/CaseId" } ], "responses": { "200": { "description": "Digest-bound settlement binding.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "requestId" ], "properties": { "data": { "$ref": "#/components/schemas/PartnerSettlementBinding" }, "requestId": { "type": "string" } } } } } }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/cases/{caseId}/settlement-executions": { "post": { "security": [ { "settlementAdapterBearer": [] } ], "tags": [ "Settlement" ], "operationId": "executeSettlementV2", "summary": "Validate or execute the authorized settlement action", "description": "Requires a credential with the dedicated settlement:execute capability bound to the exact adapter. The action is derived from the served evaluation outcome, never supplied by the caller. Dry runs append a validated receipt; live calls append an immutable caller attempt linked to one server-derived business-operation journal. Different caller idempotency keys cannot resubmit the same binding, operative Award revision/hash, and action. Unknown provider outcomes require reconciliation before any terminal result is reported.", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PartnerSettlementExecutionInput" } } } }, "responses": { "201": { "description": "Immutable validation or execution attempt.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "requestId" ], "properties": { "data": { "$ref": "#/components/schemas/PartnerSettlementAttempt" }, "requestId": { "type": "string" } } } } } }, "default": { "$ref": "#/components/responses/Problem" } } }, "get": { "security": [ { "settlementAdapterBearer": [] } ], "tags": [ "Settlement" ], "operationId": "listSettlementExecutionsV2", "summary": "List settlement attempts and business operations", "parameters": [ { "$ref": "#/components/parameters/CaseId" } ], "responses": { "200": { "description": "Immutable caller attempts and the authoritative business-operation journal.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "requestId" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "caseId", "attempts", "operations" ], "properties": { "schemaVersion": { "type": "string", "const": "partner-settlement-attempt-list-v2" }, "caseId": { "type": "string" }, "attempts": { "type": "array", "items": { "$ref": "#/components/schemas/PartnerSettlementAttempt" } }, "operations": { "type": "array", "items": { "$ref": "#/components/schemas/PartnerSettlementOperation" } } } }, "requestId": { "type": "string" } } } } } }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/cases/{caseId}/award/artifacts/{kind}": { "get": { "security": [ { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] } ], "tags": [ "Decisions and finality" ], "operationId": "downloadAwardArtifactV2", "summary": "Download an exact served Award artifact", "description": "PDF and DOCX retain their frozen source bytes and JSON is a separately persisted canonical award-decision-v2 exact-money derivative. The public v2 response omits the internal-identity-bearing recipe-v3 envelope. Verify every download through the signed companion attestation, which binds public case IDs, derivative artifact identity and bytes, source Award hash/disposition/revision, and all three source descriptors.", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "$ref": "#/components/parameters/PartyToken" }, { "name": "kind", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "pdf", "docx", "json" ] } } ], "responses": { "200": { "description": "Exact served award bytes." }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/cases/{caseId}/award/artifacts/json/attestation": { "get": { "security": [ { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] } ], "tags": [ "Decisions and finality" ], "operationId": "getAwardJsonAttestationV2", "summary": "Read the signed v2 JSON Award companion attestation", "description": "Returns the separately signed public-case-bound derivative attestation and exact PDF/DOCX/JSON source descriptor set. The attestation is a closed schema, so undeclared fields fail verification. The recipe-v3 bytes remain unchanged in v1 storage but its internal-identity-bearing manifest and verification envelope are not exposed by v2.", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "$ref": "#/components/parameters/PartyToken" } ], "responses": { "200": { "$ref": "#/components/responses/Data" }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/cases/{caseId}/record-bundle": { "get": { "security": [ { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] } ], "tags": [ "Decisions and finality" ], "operationId": "downloadCaseRecordBundleV2", "summary": "Download a v2 party record manifest or full verified bundle", "description": "Both forms use the isolated case-record-bundle-v2 identity and exact-money canonical JSON. Manifest responses and full bundles carry a signed v2 attestation binding partner, public case IDs, side, revision, Rules, bundle identity, and every file digest. Verification scans the entire canonical artifact for internal IDs and requires case, docket, messages, applicable decisions, and a validated award-decision-v2 plus matching trusted attestation for every required revision; filenames alone never establish completeness. The opaque sourceSnapshotHash supports deterministic cache identity without exposing any v1 source bundle ID; no recipe-v3 envelope, v1 bundle ID, or v1 cache row is exposed or reused.", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "$ref": "#/components/parameters/PartyToken" }, { "name": "format", "in": "query", "schema": { "type": "string", "enum": [ "manifest", "bundle" ], "default": "manifest" } } ], "responses": { "200": { "description": "Party record integrity manifest envelope or canonical full bundle bytes." }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/cases/{caseId}/evidence/{evidenceId}/authenticity-challenges": { "get": { "security": [ { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] } ], "tags": [ "Evidence and challenges" ], "operationId": "getAuthenticityChallengesV2", "summary": "List all party-visible challenges for an evidence item", "description": "Requires evidence:challenges:read plus active tenant case membership and side binding. Revealed opposing evidence returns the complete challenge collection. Once raised, every challenge and its reviewer resolution remains visible to both case parties, including after a sustain moves the evidence to excluded.", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "name": "evidenceId", "in": "path", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/PartyToken" } ], "responses": { "200": { "description": "Every visible challenge and reviewer resolution status.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "requestId" ], "properties": { "data": { "$ref": "#/components/schemas/PartnerAuthenticityChallengeList" }, "requestId": { "type": "string" } } } } } }, "default": { "$ref": "#/components/responses/Problem" } } }, "post": { "security": [ { "claimantAgentBearer": [] }, { "respondentAgentBearer": [] } ], "tags": [ "Evidence and challenges" ], "operationId": "raiseAuthenticityChallengeV2", "summary": "Challenge revealed opposing evidence", "description": "Requires evidence:challenges:write, Idempotency-Key, active tenant case membership, and the credential-bound side. The sanitized challenge is audit logged and docketed. Raising it contests weight only and never excludes evidence. Current Rules assign authenticity, admissibility, reliability, and weight to the AI Tribunal; historical cases retain their pinned assigned reviewer. A challenge may alternatively be embedded in a sealed rebuttal as challenges[]. Those entries are validated when filed and committed only at joint reveal, so they do not leak before the rebuttal opens.", "parameters": [ { "$ref": "#/components/parameters/CaseId" }, { "name": "evidenceId", "in": "path", "required": true, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/IdempotencyKey" }, { "$ref": "#/components/parameters/PartyToken" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PartnerAuthenticityChallengeInput" } } } }, "responses": { "200": { "description": "An already-open semantic challenge was returned without another write.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "requestId" ], "properties": { "data": { "$ref": "#/components/schemas/PartnerAuthenticityChallenge" }, "requestId": { "type": "string" } } } } } }, "201": { "description": "Challenge newly raised, or the canonical replay of that creation response.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "requestId" ], "properties": { "data": { "$ref": "#/components/schemas/PartnerAuthenticityChallenge" }, "requestId": { "type": "string" } } } } } }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/evidence-exports/notifications": { "post": { "security": [ { "evidenceExporterBearer": [] } ], "tags": [ "Evidence and challenges" ], "operationId": "notifyEvidenceExportV2", "summary": "Notify the court of a signed evidence export", "description": "Requires the evidence_exporter bearer role and all seven exporter Ed25519 signing headers. This signed mutation does not use Idempotency-Key; it deduplicates by the signed exporter and event identity.", "parameters": [ { "$ref": "#/components/parameters/ContentDigest" }, { "$ref": "#/components/parameters/PcEventId" }, { "$ref": "#/components/parameters/PcEventTimestamp" }, { "$ref": "#/components/parameters/PcKeyId" }, { "$ref": "#/components/parameters/EvidenceSchemaVersion" }, { "$ref": "#/components/parameters/PcSignatureVersion" }, { "$ref": "#/components/parameters/PcSignature" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvidenceExportNotification" } } } }, "responses": { "202": { "$ref": "#/components/responses/Data" }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/evidence-exports/receipts/{eventId}": { "get": { "security": [ { "evidenceExporterBearer": [] } ], "tags": [ "Evidence and challenges" ], "operationId": "getEvidenceExportReceiptV2", "summary": "Read an evidence export receipt", "parameters": [ { "name": "eventId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "$ref": "#/components/responses/Data" }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/webhooks/endpoints": { "post": { "security": [ { "platformOrchestratorBearer": [] } ], "tags": [ "Webhooks" ], "operationId": "createOrRotateWebhookEndpointV2", "summary": "Register or rotate the partner callback endpoint", "description": "Resolves and validates a public HTTPS destination before registration. Private, loopback, link-local, metadata, failed-DNS, and mixed-address targets are rejected; delivery revalidates and pins DNS.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PartnerWebhookEndpointInput" } } } }, "responses": { "201": { "$ref": "#/components/responses/Data" }, "default": { "$ref": "#/components/responses/Problem" } } }, "get": { "security": [ { "platformOrchestratorBearer": [] } ], "tags": [ "Webhooks" ], "operationId": "listWebhookEndpointsV2", "summary": "List registered partner callback endpoints", "responses": { "200": { "$ref": "#/components/responses/Data" }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/webhooks/deliveries": { "get": { "security": [ { "platformOrchestratorBearer": [] } ], "tags": [ "Webhooks" ], "operationId": "listWebhookDeliveriesV2", "summary": "List tenant-scoped webhook deliveries", "parameters": [ { "name": "status", "in": "query", "schema": { "type": "string", "enum": [ "pending", "sending", "delivered", "failed", "suppressed", "dead_letter" ] } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 100 } } ], "responses": { "200": { "description": "Tenant-scoped delivery history.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "requestId" ], "properties": { "data": { "type": "object", "required": [ "schemaVersion", "deliveries" ], "properties": { "schemaVersion": { "type": "string", "const": "partner-webhook-delivery-list-v2" }, "deliveries": { "type": "array", "items": { "$ref": "#/components/schemas/PartnerWebhookDelivery" } } } }, "requestId": { "type": "string" } } } } } }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/webhooks/deliveries/{deliveryId}": { "get": { "security": [ { "platformOrchestratorBearer": [] } ], "tags": [ "Webhooks" ], "operationId": "getWebhookDeliveryV2", "summary": "Read one webhook delivery and its attempts", "parameters": [ { "$ref": "#/components/parameters/WebhookDeliveryId" } ], "responses": { "200": { "description": "Delivery and immutable attempt history.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "requestId" ], "properties": { "data": { "$ref": "#/components/schemas/PartnerWebhookDelivery" }, "requestId": { "type": "string" } } } } } }, "default": { "$ref": "#/components/responses/Problem" } } } }, "/api/v2/webhooks/deliveries/{deliveryId}/replay": { "post": { "security": [ { "platformOrchestratorBearer": [] } ], "tags": [ "Webhooks" ], "operationId": "replayWebhookDeliveryV2", "summary": "Append an operator-requested delivery for an existing logical event", "parameters": [ { "$ref": "#/components/parameters/WebhookDeliveryId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false } } } }, "responses": { "201": { "description": "New delivery for the existing logical event.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "requestId" ], "properties": { "data": { "$ref": "#/components/schemas/PartnerWebhookDelivery" }, "requestId": { "type": "string" } } } } } }, "default": { "$ref": "#/components/responses/Problem" } } } } }, "webhooks": { "caseNotification": { "post": { "tags": [ "Webhooks" ], "operationId": "receivePartnerCaseNotificationV2", "summary": "Receive a sparse informational case event", "description": "Delivered at least once. Verify the Ed25519 signature, deduplicate by eventId across deliveryId values, use sequence only as an ordering cursor, acknowledge promptly, and fetch authoritative state before acting.", "parameters": [ { "$ref": "#/components/parameters/ContentDigest" }, { "$ref": "#/components/parameters/PcEventId" }, { "$ref": "#/components/parameters/PcEventTimestamp" }, { "$ref": "#/components/parameters/PcKeyId" }, { "$ref": "#/components/parameters/CaseEventSchemaVersion" }, { "$ref": "#/components/parameters/PcSignatureVersion" }, { "$ref": "#/components/parameters/PcSignature" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "eventId", "deliveryId", "sequence", "type", "occurredAt", "caseId", "externalCaseId", "actionRequired" ], "properties": { "schemaVersion": { "type": "string", "const": "case-event-v2" }, "eventId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" }, "deliveryId": { "type": "string" }, "sequence": { "type": "integer", "minimum": 1 }, "type": { "type": "string" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$" }, "caseId": { "type": "string" }, "externalCaseId": { "type": "string" }, "actionRequired": { "type": "boolean" }, "deadlineAt": { "type": "string", "format": "date-time", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$" } } } } } }, "responses": { "204": { "description": "Event accepted." } } } } }, "components": { "securitySchemes": { "platformOrchestratorBearer": { "type": "http", "scheme": "bearer", "description": "Credential bound to the platform_orchestrator role." }, "claimantAgentBearer": { "type": "http", "scheme": "bearer", "description": "Credential bound to the claimant_agent role. Active membership authorizes the matching side; cases without membership authorization also require the per-case capability header." }, "respondentAgentBearer": { "type": "http", "scheme": "bearer", "description": "Credential bound to the respondent_agent role. Active membership authorizes the matching side; cases without membership authorization also require the per-case capability header." }, "evidenceExporterBearer": { "type": "http", "scheme": "bearer", "description": "Credential bound to one evidence_exporter resource." }, "settlementAdapterBearer": { "type": "http", "scheme": "bearer", "description": "Credential carrying only settlement:execute and bound to one exact adapter resource." }, "readOnlyObserverBearer": { "type": "http", "scheme": "bearer", "description": "Credential bound to the read_only_observer role and limited to operational projections." } }, "parameters": { "CaseId": { "name": "caseId", "in": "path", "required": true, "schema": { "type": "string" } }, "DraftId": { "name": "draftId", "in": "path", "required": true, "schema": { "type": "string" } }, "IdempotencyKey": { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 200 } }, "WebhookDeliveryId": { "name": "deliveryId", "in": "path", "required": true, "schema": { "type": "string" } }, "Party": { "name": "x-pc-party", "in": "header", "required": true, "schema": { "type": "string", "enum": [ "claimant", "respondent" ] } }, "PartyToken": { "name": "x-arb-party-token", "in": "header", "required": false, "schema": { "type": "string" }, "description": "Per-case capability used when membership authorization is unavailable. Optional with active membership for the matching side." }, "ContentDigest": { "name": "content-digest", "in": "header", "required": true, "description": "SHA-256 of the exact request bytes, formatted as an RFC 9530-style binary content digest. It is the final line of the canonical signature input.", "schema": { "type": "string", "pattern": "^sha-256=:[A-Za-z0-9+/]{43}=:$" } }, "PcEventId": { "name": "x-pc-event-id", "in": "header", "required": true, "description": "Stable signed event identity used for deduplication.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" } }, "PcEventTimestamp": { "name": "x-pc-event-timestamp", "in": "header", "required": true, "description": "Canonical UTC ISO 8601 instant (the value must equal new Date(value).toISOString()).", "schema": { "type": "string", "format": "date-time", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$" } }, "PcKeyId": { "name": "x-pc-key-id", "in": "header", "required": true, "description": "Identifier of the Ed25519 verification key.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" } }, "CaseEventSchemaVersion": { "name": "x-pc-schema-version", "in": "header", "required": true, "description": "Signed body schema version; must equal the body schemaVersion.", "schema": { "type": "string", "const": "case-event-v2" } }, "EvidenceSchemaVersion": { "name": "x-pc-schema-version", "in": "header", "required": true, "description": "Signed body schema version; must equal the body schemaVersion.", "schema": { "type": "string", "const": "evidence-export-notification-v1" } }, "PcSignatureVersion": { "name": "x-pc-signature-version", "in": "header", "required": true, "description": "Signature protocol version. It is validated as a constant; the canonical input is version-defined and does not include this header or the signature itself.", "schema": { "type": "string", "const": "pc-webhook-ed25519-v1" } }, "PcSignature": { "name": "x-pc-signature", "in": "header", "required": true, "description": "Ed25519 signature over the documented canonical input.", "schema": { "type": "string", "pattern": "^ed25519=:[A-Za-z0-9+/]{86}==:$" } } }, "schemas": { "Ap2SdJwtArtifactV1": { "type": "object", "additionalProperties": false, "required": [ "artifactId", "compactSdJwt", "disclosures", "keyBindingJwt" ], "properties": { "artifactId": { "type": "string" }, "compactSdJwt": { "type": "string" }, "disclosures": { "type": "array", "items": { "type": "string" } }, "keyBindingJwt": { "type": [ "string", "null" ] } } }, "Ap2TrustKeyV1": { "type": "object", "additionalProperties": false, "required": [ "issuer", "ap2Role", "kid", "alg", "purpose", "publicJwk", "thumbprintSha256", "notBefore", "expiresAt" ], "properties": { "issuer": { "type": "string" }, "ap2Role": { "type": "string", "enum": [ "trusted_surface", "credential_provider", "shopping_agent", "merchant", "merchant_payment_processor", "principal" ] }, "kid": { "type": "string" }, "alg": { "type": "string", "enum": [ "EdDSA", "ES256" ] }, "purpose": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "checkout_mandate", "payment_mandate", "key_binding", "checkout_jwt", "checkout_receipt", "payment_receipt", "resolution_authorization" ] } }, "publicJwk": { "type": "object", "description": "Public asymmetric JWK only; private d and symmetric k members are rejected." }, "thumbprintSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "notBefore": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" } }, "allOf": [ { "if": { "properties": { "purpose": { "contains": { "type": "string", "const": "resolution_authorization" } } }, "required": [ "purpose" ] }, "then": { "properties": { "ap2Role": { "type": "string", "const": "principal" }, "purpose": { "type": "array", "minItems": 1, "maxItems": 1, "items": { "type": "string", "const": "resolution_authorization" } } } } } ] }, "Ap2EvidencePackageV1": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "ap2SpecVersion", "evidenceId", "transactionId", "acquiredAt", "source", "artifacts", "trust" ], "properties": { "schemaVersion": { "type": "string", "const": "ap2-evidence-package-v1" }, "ap2SpecVersion": { "type": "string", "const": "0.2" }, "evidenceId": { "type": "string" }, "transactionId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{43}$" }, "acquiredAt": { "type": "string", "format": "date-time" }, "source": { "type": "object", "additionalProperties": false, "required": [ "partnerId", "exporterId", "sourceRoles" ], "properties": { "partnerId": { "type": "string" }, "exporterId": { "type": "string" }, "sourceRoles": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "trusted_surface", "credential_provider", "shopping_agent", "merchant", "merchant_payment_processor" ] } } } }, "artifacts": { "type": "object", "additionalProperties": false, "required": [ "checkoutMandates", "checkoutJwt", "checkoutReceipt", "paymentMandates", "paymentReceipt" ], "properties": { "checkoutMandates": { "type": "object", "additionalProperties": false, "required": [ "open", "closed" ], "properties": { "open": { "type": "array", "minItems": 1, "items": { "$ref": "#/components/schemas/Ap2SdJwtArtifactV1" } }, "closed": { "$ref": "#/components/schemas/Ap2SdJwtArtifactV1" } } }, "checkoutJwt": { "type": "object", "additionalProperties": false, "required": [ "artifactId", "compactJwt" ], "properties": { "artifactId": { "type": "string" }, "compactJwt": { "type": "string" } } }, "checkoutReceipt": { "type": "object", "additionalProperties": false, "required": [ "artifactId", "compactJws" ], "properties": { "artifactId": { "type": "string" }, "compactJws": { "type": "string" } } }, "paymentMandates": { "type": "object", "additionalProperties": false, "required": [ "open", "closed" ], "properties": { "open": { "type": "array", "minItems": 1, "items": { "$ref": "#/components/schemas/Ap2SdJwtArtifactV1" } }, "closed": { "$ref": "#/components/schemas/Ap2SdJwtArtifactV1" } } }, "paymentReceipt": { "type": "object", "additionalProperties": false, "required": [ "artifactId", "compactJws" ], "properties": { "artifactId": { "type": "string" }, "compactJws": { "type": "string" } } } } }, "trust": { "type": "object", "additionalProperties": false, "required": [ "policyId", "policyVersion", "exporterAttestationJws", "keys" ], "properties": { "policyId": { "type": "string" }, "policyVersion": { "type": "string" }, "exporterAttestationJws": { "type": "string" }, "keys": { "type": "array", "minItems": 1, "items": { "$ref": "#/components/schemas/Ap2TrustKeyV1" } } } } } }, "Ap2TransactionEvidenceV1": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "ap2SpecVersion", "evidenceId", "transactionId", "acquiredAt", "source", "originalArtifacts", "sdJwtDisclosures", "checkoutJwt", "signingTrust", "normalizedTransaction", "verificationReport", "artifactHashes", "manifestHash" ], "properties": { "schemaVersion": { "type": "string", "const": "ap2-transaction-evidence-v1" }, "ap2SpecVersion": { "type": "string" }, "evidenceId": { "type": "string" }, "transactionId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{43}$" }, "acquiredAt": { "type": "string", "format": "date-time" }, "source": { "type": "object", "additionalProperties": false, "required": [ "partnerId", "exporterId", "sourceRoles" ], "properties": { "partnerId": { "type": "string" }, "exporterId": { "type": "string" }, "sourceRoles": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "trusted_surface", "credential_provider", "shopping_agent", "merchant", "merchant_payment_processor" ] } } } }, "originalArtifacts": { "type": "object", "additionalProperties": false, "required": [ "checkoutMandates", "checkoutJwt", "checkoutReceipt", "paymentMandates", "paymentReceipt" ], "properties": { "checkoutMandates": { "type": "object", "additionalProperties": false, "required": [ "open", "closed" ], "properties": { "open": { "type": "array", "minItems": 1, "items": { "$ref": "#/components/schemas/Ap2SdJwtArtifactV1" } }, "closed": { "$ref": "#/components/schemas/Ap2SdJwtArtifactV1" } } }, "checkoutJwt": { "type": "object", "additionalProperties": false, "required": [ "artifactId", "compactJwt" ], "properties": { "artifactId": { "type": "string" }, "compactJwt": { "type": "string" } } }, "checkoutReceipt": { "type": "object", "additionalProperties": false, "required": [ "artifactId", "compactJws" ], "properties": { "artifactId": { "type": "string" }, "compactJws": { "type": "string" } } }, "paymentMandates": { "type": "object", "additionalProperties": false, "required": [ "open", "closed" ], "properties": { "open": { "type": "array", "minItems": 1, "items": { "$ref": "#/components/schemas/Ap2SdJwtArtifactV1" } }, "closed": { "$ref": "#/components/schemas/Ap2SdJwtArtifactV1" } } }, "paymentReceipt": { "type": "object", "additionalProperties": false, "required": [ "artifactId", "compactJws" ], "properties": { "artifactId": { "type": "string" }, "compactJws": { "type": "string" } } } } }, "sdJwtDisclosures": { "type": "object", "additionalProperties": false, "required": [ "checkout", "payment" ], "properties": { "checkout": { "type": "array", "items": { "type": "array", "items": { "type": "string" } } }, "payment": { "type": "array", "items": { "type": "array", "items": { "type": "string" } } } } }, "checkoutJwt": { "type": "string" }, "signingTrust": { "type": "object", "additionalProperties": false, "required": [ "policyId", "policyVersion", "exporterAttestationJws", "keys" ], "properties": { "policyId": { "type": "string" }, "policyVersion": { "type": "string" }, "exporterAttestationJws": { "type": "string" }, "keys": { "type": "array", "minItems": 1, "items": { "$ref": "#/components/schemas/Ap2TrustKeyV1" } } } }, "normalizedTransaction": { "type": "object", "additionalProperties": false, "required": [ "checkoutHash", "checkoutReceiptReference", "paymentReceiptReference", "merchantId", "orderId", "paymentId", "lineItemIds", "currency", "amountMinorUnits", "payee", "paymentAmount", "paymentInstrument" ], "properties": { "checkoutHash": { "type": "string" }, "checkoutReceiptReference": { "type": "string" }, "paymentReceiptReference": { "type": "string" }, "merchantId": { "type": "string" }, "orderId": { "type": "string" }, "paymentId": { "type": "string" }, "lineItemIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string" } }, "currency": { "type": "string" }, "amountMinorUnits": { "type": "string" }, "payee": { "type": "string" }, "paymentAmount": { "type": "string" }, "paymentInstrument": { "type": "string" } } }, "verificationReport": { "type": "object", "additionalProperties": false, "required": [ "verifier", "status", "verifiedAt", "trustPolicyId", "trustPolicyVersion", "checks", "missingArtifacts" ], "properties": { "verifier": { "type": "string", "const": "peoples-court-ap2-bridge-v1" }, "status": { "type": "string", "const": "passed" }, "verifiedAt": { "type": "string", "format": "date-time" }, "trustPolicyId": { "type": "string" }, "trustPolicyVersion": { "type": "string" }, "checks": { "type": "array", "minItems": 1, "items": { "type": "object", "additionalProperties": false, "required": [ "code", "status", "artifactIds", "detailCode" ], "properties": { "code": { "type": "string" }, "status": { "type": "string", "const": "passed" }, "artifactIds": { "type": "array", "items": { "type": "string" } }, "detailCode": { "type": "null" } } } }, "missingArtifacts": { "type": "array", "maxItems": 0, "items": { "type": "string" } } } }, "artifactHashes": { "type": "array", "minItems": 7, "items": { "type": "object", "additionalProperties": false, "required": [ "artifactId", "mediaType", "byteLength", "sha256" ], "properties": { "artifactId": { "type": "string" }, "mediaType": { "type": "string" }, "byteLength": { "type": "integer", "minimum": 1 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } } }, "manifestHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } }, "ResolutionAuthorizationV1": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "authorizationId", "transactionId", "effectiveAt", "expiresAt", "principals", "coveredTransaction", "coveredClaims", "appointment", "rules", "terms", "availableRemedies", "executionProvider", "proof" ], "properties": { "schemaVersion": { "type": "string", "const": "resolution-authorization-v1" }, "authorizationId": { "type": "string" }, "transactionId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{43}$" }, "effectiveAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" }, "principals": { "type": "array", "minItems": 2, "maxItems": 2, "allOf": [ { "contains": { "type": "object", "properties": { "side": { "type": "string", "const": "claimant" } }, "required": [ "side" ] }, "minContains": 1, "maxContains": 1 }, { "contains": { "type": "object", "properties": { "side": { "type": "string", "const": "respondent" } }, "required": [ "side" ] }, "minContains": 1, "maxContains": 1 } ], "items": { "type": "object", "additionalProperties": false, "required": [ "side", "principalId", "displayName", "capacity", "notice", "agentAuthority" ], "properties": { "side": { "type": "string", "enum": [ "claimant", "respondent" ] }, "principalId": { "type": "string" }, "displayName": { "type": "string" }, "capacity": { "type": "string", "enum": [ "individual", "legal_entity", "autonomous_agent" ] }, "notice": { "type": "object", "additionalProperties": false, "required": [ "method", "address" ], "properties": { "method": { "type": "string", "enum": [ "email", "partner_callback", "case_page" ] }, "address": { "type": "string" } } }, "agentAuthority": { "type": "object", "additionalProperties": false, "required": [ "agentId", "representedPrincipalId", "allowedActs", "maximumAmount", "expiresAt", "delegationArtifactRef", "delegationArtifactHash" ], "properties": { "agentId": { "type": "string" }, "representedPrincipalId": { "type": "string" }, "allowedActs": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "file_dispute", "submit_evidence", "settle_dispute", "confirm_record" ] } }, "maximumAmount": { "$ref": "#/components/schemas/ResolutionMoneyV1" }, "expiresAt": { "type": "string", "format": "date-time" }, "delegationArtifactRef": { "type": "string" }, "delegationArtifactHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } } } } }, "coveredTransaction": { "type": "object", "additionalProperties": false, "required": [ "transactionId", "merchantOrCounterpartyId", "evidenceManifestHash" ], "properties": { "transactionId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{43}$" }, "merchantOrCounterpartyId": { "type": "string" }, "evidenceManifestHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } }, "coveredClaims": { "$ref": "#/components/schemas/ResolutionCoveredClaimsV1" }, "appointment": { "$ref": "#/components/schemas/ResolutionAppointmentV1" }, "rules": { "$ref": "#/components/schemas/ResolutionRulesV1" }, "terms": { "$ref": "#/components/schemas/ResolutionTermsV1" }, "legalContext": { "$ref": "#/components/schemas/ResolutionLegalContextBindingV1" }, "availableRemedies": { "type": "array", "minItems": 1, "items": { "$ref": "#/components/schemas/ResolutionRemedyV1" } }, "executionProvider": { "$ref": "#/components/schemas/ResolutionExecutionProviderV1" }, "proof": { "type": "object", "additionalProperties": false, "required": [ "format", "payload", "signatures" ], "properties": { "format": { "type": "string", "const": "jws-json-general" }, "payload": { "type": "string" }, "signatures": { "type": "array", "minItems": 2, "maxItems": 2, "items": { "type": "object", "additionalProperties": false, "required": [ "protected", "signature" ], "properties": { "protected": { "type": "string" }, "signature": { "type": "string" } } } } } } } }, "ResolutionMoneyV1": { "type": "object", "additionalProperties": false, "required": [ "currency", "minorUnits" ], "properties": { "currency": { "type": "string", "const": "USD" }, "minorUnits": { "type": "string", "pattern": "^[1-9][0-9]{0,14}$", "description": "Positive USD minor units, capped at exactly 15 decimal digits by Bridge v1." } } }, "ResolutionCoveredClaimsV1": { "type": "object", "additionalProperties": false, "required": [ "scope", "claimTypes", "maximumAmount" ], "properties": { "scope": { "type": "string" }, "claimTypes": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string" } }, "maximumAmount": { "$ref": "#/components/schemas/ResolutionMoneyV1" } } }, "ResolutionAppointmentV1": { "type": "object", "additionalProperties": false, "required": [ "administrator", "tribunal", "caseMode", "procedureProfile" ], "properties": { "administrator": { "type": "string", "const": "People's Court" }, "tribunal": { "type": "string", "const": "People's Court Tribunal" }, "caseMode": { "type": "string", "const": "evaluation" }, "procedureProfile": { "type": "string", "const": "evaluation" } } }, "ResolutionRulesV1": { "type": "object", "additionalProperties": false, "required": [ "rulesetId", "version", "hash", "url" ], "properties": { "rulesetId": { "type": "string" }, "version": { "type": "string" }, "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "url": { "type": "string", "format": "uri", "pattern": "^https://" } } }, "ResolutionTermsV1": { "type": "object", "additionalProperties": false, "required": [ "version", "hash" ], "properties": { "version": { "type": "string" }, "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } }, "ResolutionLegalContextBindingV1": { "type": "object", "additionalProperties": false, "required": [ "lcpSpecVersion", "legalContextSha256", "termsAtrHash", "clauseId", "clauseSha256", "rulesSha256", "catalogSha256", "providerId", "serviceId" ], "properties": { "lcpSpecVersion": { "type": "string", "const": "0.1.38" }, "legalContextSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "termsAtrHash": { "type": "string", "pattern": "^0x[a-f0-9]{64}$" }, "clauseId": { "type": "string", "pattern": "^sha256:0x[a-f0-9]{64}$" }, "clauseSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "rulesSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "catalogSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "providerId": { "type": "string", "minLength": 1, "maxLength": 16384 }, "serviceId": { "type": "string", "minLength": 1, "maxLength": 16384 } } }, "ResolutionRemedyV1": { "type": "object", "additionalProperties": false, "required": [ "code", "settlementAction", "maximumAmount" ], "properties": { "code": { "type": "string" }, "settlementAction": { "type": "string", "enum": [ "release_to_claimant", "release_to_respondent", "allocate_by_award", "none" ] }, "maximumAmount": { "$ref": "#/components/schemas/ResolutionMoneyV1" } } }, "ResolutionExecutionProviderV1": { "type": "object", "additionalProperties": false, "required": [ "providerId", "adapter", "mode", "externalReference", "allowedActions", "authorizationExpiresAt" ], "properties": { "providerId": { "type": "string" }, "adapter": { "type": "string" }, "mode": { "type": "string", "enum": [ "manual_partner", "partner_callback", "platform_adapter" ] }, "externalReference": { "type": "string" }, "allowedActions": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "release_to_claimant", "release_to_respondent", "allocate_by_award", "none" ] } }, "authorizationExpiresAt": { "type": "string", "format": "date-time" } } }, "ResolutionProposedCaseV1": { "description": "Unsigned transport intent compared exactly to both principals' signed authorization; it is never treated as consent.", "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "transactionId", "claimantPrincipalId", "respondentPrincipalId", "merchantOrCounterpartyId", "evidenceManifestHash", "coveredClaims", "appointment", "rules", "terms", "availableRemedies", "requestedRemedy", "executionProvider" ], "properties": { "schemaVersion": { "type": "string", "const": "resolution-proposed-case-v1" }, "transactionId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{43}$" }, "claimantPrincipalId": { "type": "string" }, "respondentPrincipalId": { "type": "string" }, "merchantOrCounterpartyId": { "type": "string" }, "evidenceManifestHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "coveredClaims": { "$ref": "#/components/schemas/ResolutionCoveredClaimsV1" }, "appointment": { "$ref": "#/components/schemas/ResolutionAppointmentV1" }, "rules": { "$ref": "#/components/schemas/ResolutionRulesV1" }, "terms": { "$ref": "#/components/schemas/ResolutionTermsV1" }, "legalContext": { "$ref": "#/components/schemas/ResolutionLegalContextBindingV1" }, "availableRemedies": { "type": "array", "minItems": 1, "items": { "$ref": "#/components/schemas/ResolutionRemedyV1" } }, "requestedRemedy": { "type": "object", "additionalProperties": false, "required": [ "action", "currency", "minorUnits" ], "properties": { "action": { "type": "string", "enum": [ "release_to_claimant", "release_to_respondent", "allocate_by_award", "none" ] }, "currency": { "type": "string", "const": "USD" }, "minorUnits": { "type": "string", "pattern": "^[1-9][0-9]{0,14}$" } } }, "executionProvider": { "$ref": "#/components/schemas/ResolutionExecutionProviderV1" } } }, "ResolutionFrozenRecordManifestV1": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "transactionId", "orderId", "disputedLineItemIds", "policyDigest", "termsDigest", "authorityRefs", "includedArtifacts", "excludedArtifacts" ], "properties": { "schemaVersion": { "type": "string", "const": "resolution-frozen-record-manifest-v1" }, "transactionId": { "type": "string" }, "orderId": { "type": "string" }, "disputedLineItemIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string" } }, "policyDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "termsDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "authorityRefs": { "type": "array", "minItems": 2, "uniqueItems": true, "items": { "type": "string" } }, "includedArtifacts": { "type": "array", "minItems": 1, "items": { "type": "object", "additionalProperties": false, "required": [ "artifactId", "sha256", "mediaType", "source" ], "properties": { "artifactId": { "type": "string" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "mediaType": { "type": "string" }, "source": { "type": "string" } } } }, "excludedArtifacts": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "artifactId", "reason" ], "properties": { "artifactId": { "type": "string" }, "reason": { "type": "string", "enum": [ "verifier_local_metadata", "outside_claim_scope", "duplicate" ] } } } } } }, "ResolutionHandoffV1": { "description": "Protocol-neutral frozen resolution input. Native verification provenance is excluded from stable artifact identity.", "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "handoffId", "disputeId", "nativeProtocol", "transaction", "roles", "claim", "merchantResponse", "requestedRemedy", "authority", "policy", "terms", "frozenRecord", "remedyCeilings", "resolver", "createdAt", "expiresAt", "nativeProof" ], "properties": { "schemaVersion": { "type": "string", "const": "resolution-handoff-v1" }, "handoffId": { "type": "string" }, "disputeId": { "type": "string" }, "nativeProtocol": { "type": "string", "enum": [ "ucp", "ap2", "x402", "a2a", "agentic_checkout_acp", "virtuals_acp", "custom" ] }, "transaction": { "type": "object", "additionalProperties": false, "required": [ "transactionId", "orderId", "disputedLineItemIds" ], "properties": { "transactionId": { "type": "string" }, "orderId": { "type": "string" }, "checkoutId": { "type": "string" }, "disputedLineItemIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string" } } } }, "roles": { "type": "object", "additionalProperties": false, "required": [ "claimant", "respondent", "recordIssuer", "resolver", "executor" ], "properties": { "claimant": { "type": "string" }, "respondent": { "type": "string" }, "recordIssuer": { "type": "string" }, "resolver": { "type": "string" }, "executor": { "type": "string" } } }, "claim": { "type": "object", "additionalProperties": false, "required": [ "claimId", "claimType", "artifactRef", "artifactHash" ], "properties": { "claimId": { "type": "string" }, "claimType": { "type": "string" }, "artifactRef": { "type": "string" }, "artifactHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } }, "merchantResponse": { "type": "object", "additionalProperties": false, "required": [ "response", "artifactRef", "artifactHash" ], "properties": { "response": { "type": "string", "enum": [ "accepted", "partially_accepted", "denied", "no_response" ] }, "artifactRef": { "type": "string" }, "artifactHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } }, "requestedRemedy": { "$ref": "#/components/schemas/ResolutionHandoffRemedyV1" }, "authority": { "type": "object", "additionalProperties": false, "required": [ "bilateral", "claimantAuthorityRef", "respondentAuthorityRef", "authorizationArtifactHash" ], "properties": { "bilateral": { "type": "boolean", "const": true }, "claimantAuthorityRef": { "type": "string" }, "respondentAuthorityRef": { "type": "string" }, "authorizationArtifactHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } }, "policy": { "$ref": "#/components/schemas/ResolutionDigestVersionV1" }, "terms": { "$ref": "#/components/schemas/ResolutionDigestVersionV1" }, "frozenRecord": { "type": "object", "additionalProperties": false, "required": [ "canonicalization", "digestAlgorithm", "manifest", "digest" ], "properties": { "canonicalization": { "type": "string", "const": "RFC8785" }, "digestAlgorithm": { "type": "string", "const": "SHA-256" }, "manifest": { "$ref": "#/components/schemas/ResolutionFrozenRecordManifestV1" }, "digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } }, "remedyCeilings": { "type": "array", "minItems": 1, "items": { "$ref": "#/components/schemas/ResolutionHandoffRemedyV1" } }, "resolver": { "type": "object", "additionalProperties": false, "required": [ "resolverId", "rulesetId", "rulesVersion" ], "properties": { "resolverId": { "type": "string" }, "rulesetId": { "type": "string" }, "rulesVersion": { "type": "string" } } }, "createdAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" }, "nativeProof": { "type": "object", "additionalProperties": false, "required": [ "artifactRef", "sha256", "verificationMethod" ], "properties": { "artifactRef": { "type": "string" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "verificationMethod": { "type": "string" } } }, "nativeVerification": { "type": "object", "additionalProperties": false, "required": [ "verifierId", "verifiedAt" ], "properties": { "verifierId": { "type": "string" }, "verifiedAt": { "type": "string", "format": "date-time" }, "fetchMetadata": { "type": "object", "additionalProperties": true } } } } }, "ResolutionHandoffRemedyV1": { "type": "object", "additionalProperties": false, "required": [ "action", "currency", "amountMinorUnits" ], "properties": { "action": { "type": "string", "enum": [ "refund", "release_to_claimant", "release_to_respondent", "allocate_by_award", "replace_product", "none" ] }, "currency": { "type": "string" }, "amountMinorUnits": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" } } }, "ResolutionDigestVersionV1": { "type": "object", "additionalProperties": false, "required": [ "version", "digest" ], "properties": { "version": { "type": "string" }, "digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } }, "UcpOrderEvidenceV1": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "selectedUcpVersion", "profileId", "businessId", "orderId", "orderBytesBase64", "httpMessage" ], "properties": { "schemaVersion": { "type": "string", "const": "ucp-order-evidence-v1" }, "selectedUcpVersion": { "type": "string", "const": "2026-04-08" }, "profileId": { "type": "string" }, "businessId": { "type": "string" }, "orderId": { "type": "string" }, "orderBytesBase64": { "type": "string", "description": "Exact received UCP Order bytes encoded as canonical base64; re-serialization is not permitted." }, "httpMessage": { "type": "object", "additionalProperties": false, "required": [ "method", "targetUri", "contentDigest", "signatureInput", "signature" ], "properties": { "method": { "type": "string" }, "targetUri": { "type": "string", "format": "uri" }, "contentDigest": { "type": "string" }, "signatureInput": { "type": "string" }, "signature": { "type": "string" } } } } }, "UcpResolutionRequestV1": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "externalCaseId", "policyVersion", "exporterId", "orderEvidence", "resolutionHandoff", "resolutionAuthorization", "proposedCase" ], "properties": { "schemaVersion": { "type": "string", "const": "ucp-resolution-request-v1" }, "externalCaseId": { "type": "string" }, "policyVersion": { "type": "string" }, "exporterId": { "type": "string" }, "orderEvidence": { "$ref": "#/components/schemas/UcpOrderEvidenceV1" }, "resolutionHandoff": { "$ref": "#/components/schemas/ResolutionHandoffV1" }, "resolutionAuthorization": { "$ref": "#/components/schemas/ResolutionAuthorizationV1" }, "proposedCase": { "$ref": "#/components/schemas/ResolutionProposedCaseV1" } } }, "Ap2ResolutionRequestV1": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "externalCaseId", "policyVersion", "evidencePackage", "resolutionAuthorization", "proposedCase" ], "properties": { "schemaVersion": { "type": "string", "const": "ap2-resolution-request-v1" }, "externalCaseId": { "type": "string" }, "policyVersion": { "type": "string" }, "evidencePackage": { "$ref": "#/components/schemas/Ap2EvidencePackageV1" }, "resolutionAuthorization": { "$ref": "#/components/schemas/ResolutionAuthorizationV1" }, "proposedCase": { "$ref": "#/components/schemas/ResolutionProposedCaseV1" } } }, "Ap2ResolutionCaseV1": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "caseId", "externalCaseId", "status", "rules", "createdAt", "headless", "transactionId", "evidence", "resolutionAuthorization", "resolutionLifecycle", "settlementBinding", "resultPath" ], "properties": { "schemaVersion": { "type": "string", "const": "ap2-resolution-case-v1" }, "caseId": { "type": "string" }, "externalCaseId": { "type": "string" }, "status": { "type": "string" }, "rules": { "type": "object", "additionalProperties": false, "required": [ "version", "hash" ], "properties": { "version": { "type": "string" }, "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } }, "createdAt": { "type": "string", "format": "date-time" }, "headless": { "type": "object", "additionalProperties": false, "required": [ "respondentHandoffPath", "answerPath", "capabilityDelivery" ], "properties": { "respondentHandoffPath": { "type": "string" }, "answerPath": { "type": "string" }, "capabilityDelivery": { "type": "string", "const": "show_once_not_replayed" } } }, "transactionId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{43}$" }, "evidence": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "manifestHash", "verificationStatus", "exportRecordId", "workflowStatus" ], "properties": { "schemaVersion": { "type": "string", "const": "ap2-transaction-evidence-v1" }, "manifestHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "verificationStatus": { "type": "string", "const": "passed" }, "exportRecordId": { "type": "string" }, "workflowStatus": { "type": "string", "const": "candidate_not_adopted" } } }, "resolutionAuthorization": { "type": "object", "additionalProperties": false, "required": [ "authorizationId", "authorizationHash", "signingSides" ], "properties": { "authorizationId": { "type": "string" }, "authorizationHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "signingSides": { "type": "array", "prefixItems": [ { "type": "string", "const": "claimant" }, { "type": "string", "const": "respondent" } ], "minItems": 2, "maxItems": 2 } } }, "resolutionLifecycle": { "$ref": "#/components/schemas/ResolutionLifecycleReferenceV1" }, "settlementBinding": { "type": "object", "additionalProperties": false, "required": [ "bindingId", "bindingDigest", "mode", "providerId" ], "properties": { "bindingId": { "type": "string" }, "bindingDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "mode": { "type": "string", "enum": [ "manual_partner", "partner_callback", "platform_adapter" ] }, "providerId": { "type": "string" } } }, "resultPath": { "type": "string" } } }, "ResolutionLifecycleReferenceV1": { "type": "object", "additionalProperties": false, "required": [ "handoffId", "handoffDigest", "frozenRecordDigest" ], "properties": { "handoffId": { "type": "string" }, "handoffDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "frozenRecordDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } }, "UcpResolutionCaseV1": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "caseId", "externalCaseId", "status", "rules", "createdAt", "headless", "transactionId", "evidence", "resolutionAuthorization", "resolutionLifecycle", "settlementBinding", "resultPath" ], "properties": { "schemaVersion": { "type": "string", "const": "ucp-resolution-case-v1" }, "caseId": { "type": "string" }, "externalCaseId": { "type": "string" }, "status": { "type": "string" }, "rules": { "type": "object", "additionalProperties": false, "required": [ "version", "hash" ], "properties": { "version": { "type": "string" }, "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } }, "createdAt": { "type": "string", "format": "date-time" }, "headless": { "type": "object", "additionalProperties": false, "required": [ "respondentHandoffPath", "answerPath", "capabilityDelivery" ], "properties": { "respondentHandoffPath": { "type": "string" }, "answerPath": { "type": "string" }, "capabilityDelivery": { "type": "string", "const": "show_once_not_replayed" } } }, "transactionId": { "type": "string" }, "evidence": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "orderSha256", "frozenRecordDigest", "verificationStatus", "exportRecordId", "workflowStatus" ], "properties": { "schemaVersion": { "type": "string", "const": "verified-ucp-order-evidence-v1" }, "orderSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "frozenRecordDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "verificationStatus": { "type": "string", "const": "passed" }, "exportRecordId": { "type": "string" }, "workflowStatus": { "type": "string", "const": "candidate_not_adopted" } } }, "resolutionAuthorization": { "type": "object", "additionalProperties": false, "required": [ "authorizationId", "authorizationHash", "signingSides" ], "properties": { "authorizationId": { "type": "string" }, "authorizationHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "signingSides": { "type": "array", "prefixItems": [ { "type": "string", "const": "claimant" }, { "type": "string", "const": "respondent" } ], "minItems": 2, "maxItems": 2 } } }, "resolutionLifecycle": { "$ref": "#/components/schemas/ResolutionLifecycleReferenceV1" }, "settlementBinding": { "type": "object", "additionalProperties": false, "required": [ "bindingId", "bindingDigest", "mode", "providerId" ], "properties": { "bindingId": { "type": "string" }, "bindingDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "mode": { "type": "string", "enum": [ "manual_partner", "partner_callback", "platform_adapter" ] }, "providerId": { "type": "string" } } }, "resultPath": { "type": "string" } } }, "ResolutionResultV1": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "authorizationId", "transactionId", "caseId", "externalCaseId", "awardReference", "review", "authorizedRemedy", "execution", "projectedAt" ], "properties": { "schemaVersion": { "type": "string", "const": "resolution-result-v1" }, "authorizationId": { "type": "string" }, "transactionId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{43}$" }, "caseId": { "type": "string" }, "externalCaseId": { "type": "string" }, "awardReference": { "oneOf": [ { "type": "null" }, { "type": "object", "additionalProperties": false, "required": [ "dispositionId", "awardRevision", "awardHash", "awardArtifactPath", "awardAttestationPath", "recordBundlePath" ], "properties": { "dispositionId": { "type": "string" }, "awardRevision": { "type": "integer", "minimum": 1 }, "awardHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "awardArtifactPath": { "type": "string" }, "awardAttestationPath": { "type": "string" }, "recordBundlePath": { "type": "string" } } } ] }, "review": { "type": "object", "additionalProperties": false, "required": [ "decisionStatus", "finality", "appealEligible", "executionHeldByAppeal", "appealDeadlineAt" ], "properties": { "decisionStatus": { "type": "string", "enum": [ "not_created", "under_review", "served" ] }, "finality": { "type": "string", "enum": [ "not_served", "served", "appealable", "appeal_reserved", "appeal_pending", "final" ] }, "appealEligible": { "type": "boolean" }, "executionHeldByAppeal": { "type": "boolean" }, "appealDeadlineAt": { "type": [ "string", "null" ], "format": "date-time" } } }, "authorizedRemedy": { "oneOf": [ { "type": "null" }, { "type": "object", "additionalProperties": false, "required": [ "outcomeCode", "action", "currency", "amountMinorUnits", "allocations", "bindingDigest" ], "properties": { "outcomeCode": { "type": "string" }, "action": { "type": "string", "enum": [ "release_to_claimant", "release_to_respondent", "allocate_by_award", "none" ] }, "currency": { "type": "string", "const": "USD" }, "amountMinorUnits": { "type": "string", "pattern": "^[1-9][0-9]{0,77}$" }, "allocations": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "recipient", "principalId", "amountMinorUnits" ], "properties": { "recipient": { "type": "string", "enum": [ "claimant", "respondent" ] }, "principalId": { "type": "string" }, "amountMinorUnits": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" } } } }, "bindingDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } } ] }, "execution": { "description": "Separate from Award finality; failure never creates a confirmation or changes the Award.", "type": "object", "additionalProperties": false, "required": [ "status", "attemptReference", "operationReference", "confirmation", "failureCode" ], "properties": { "status": { "type": "string", "enum": [ "not_ready", "not_requested", "prepared", "submitting", "validated", "manual_action_required", "callback_required", "completed", "failed", "blocked", "unknown_outcome" ] }, "attemptReference": { "type": [ "string", "null" ] }, "operationReference": { "type": [ "string", "null" ] }, "confirmation": { "oneOf": [ { "type": "null" }, { "type": "object", "additionalProperties": false, "required": [ "providerId", "adapter", "receipt", "receiptHash", "confirmedAt" ], "properties": { "providerId": { "type": "string" }, "adapter": { "type": "string" }, "receipt": { "type": "object", "additionalProperties": { "type": "string" } }, "receiptHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "confirmedAt": { "type": "string", "format": "date-time" } } } ] }, "failureCode": { "type": [ "string", "null" ] } } }, "projectedAt": { "type": "string", "format": "date-time" } } }, "FiatMoney": { "type": "object", "additionalProperties": false, "required": [ "currency", "minorUnits" ], "properties": { "currency": { "type": "string", "const": "USD" }, "minorUnits": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" } } }, "PartnerIntegrationIdentity": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "tenant", "integration", "credential" ], "properties": { "schemaVersion": { "type": "string", "const": "partner-integration-v2" }, "tenant": { "type": "object", "additionalProperties": false, "required": [ "id", "slug", "name", "environment", "status" ], "properties": { "id": { "type": "string" }, "slug": { "type": "string" }, "name": { "type": "string" }, "environment": { "type": "string", "enum": [ "test", "live" ] }, "status": { "type": "string", "enum": [ "active", "suspended" ] } } }, "integration": { "type": "object", "additionalProperties": false, "required": [ "role", "capabilities", "resourceBinding" ], "properties": { "role": { "type": "string", "enum": [ "platform_orchestrator", "claimant_agent", "respondent_agent", "evidence_exporter", "settlement_adapter", "read_only_observer" ] }, "capabilities": { "type": "array", "uniqueItems": true, "items": { "type": "string", "enum": [ "cases:prepare", "cases:read", "cases:respondent_handoff:read", "callbacks:manage", "settlement:bindings:manage", "messages:write", "evidence:challenges:read", "evidence:challenges:write", "party:claimant:act", "party:respondent:act", "party:claimant:terminate", "party:respondent:terminate", "evidence_exports:notify", "evidence_exports:receipts:read", "settlement:execute" ] } }, "resourceBinding": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "resourceId" ], "properties": { "resourceId": { "type": "string" } } }, { "type": "null" } ] } } }, "credential": { "type": "object", "additionalProperties": false, "required": [ "publicId", "prefix", "createdAt", "expiresAt" ], "properties": { "publicId": { "type": "string" }, "prefix": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": [ "string", "null" ], "format": "date-time" } } } } }, "PartnerIntegrationIdentityEnvelope": { "type": "object", "additionalProperties": false, "required": [ "data", "requestId" ], "properties": { "data": { "$ref": "#/components/schemas/PartnerIntegrationIdentity" }, "requestId": { "type": "string" } } }, "AuthorityGrantRegistration": { "type": "object", "additionalProperties": false, "required": [ "claimantPrincipalId", "externalCaseId", "transactionId", "allowedActs", "maximumAmount", "evidenceSource", "artifactRefs", "artifactHashes", "expiresAt" ], "properties": { "claimantPrincipalId": { "type": "string", "minLength": 1, "maxLength": 200 }, "externalCaseId": { "type": "string", "minLength": 1, "maxLength": 200 }, "transactionId": { "type": "string", "minLength": 1, "maxLength": 200 }, "allowedActs": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "file_dispute", "submit_evidence" ] } }, "maximumAmount": { "allOf": [ { "$ref": "#/components/schemas/FiatMoney" } ], "description": "Positive USD cents from 1 through 9007199254740991 inclusive; zero and larger values are rejected." }, "evidenceSource": { "type": "string", "minLength": 1, "maxLength": 500 }, "artifactRefs": { "type": "array", "minItems": 1, "maxItems": 20, "items": { "type": "string", "minLength": 1, "maxLength": 1000 } }, "artifactHashes": { "type": "array", "minItems": 1, "maxItems": 20, "items": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "expiresAt": { "type": "string", "format": "date-time", "example": "2026-12-01T00:00:00.000Z" } } }, "ConsentArtifactRegistration": { "type": "object", "additionalProperties": false, "required": [ "party", "principalId", "counterpartyId", "transactionId", "scope", "rulesVersion", "termsVersion", "termsHash", "artifactRef", "artifactHash", "method", "acceptedAt" ], "properties": { "party": { "type": "string", "enum": [ "claimant", "respondent" ] }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200 }, "counterpartyId": { "type": "string", "minLength": 1, "maxLength": 200 }, "transactionId": { "type": "string", "minLength": 1, "maxLength": 200 }, "scope": { "type": "string", "minLength": 1, "maxLength": 2000 }, "rulesVersion": { "type": "string", "minLength": 1, "maxLength": 100, "example": "1.0", "x-current-rules-version": true }, "termsVersion": { "type": "string", "minLength": 1, "maxLength": 100 }, "termsHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "artifactRef": { "type": "string", "minLength": 1, "maxLength": 1000 }, "artifactHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "method": { "type": "string", "enum": [ "signed_doc", "email_attest" ] }, "acceptedAt": { "type": "string", "format": "date-time", "example": "2026-08-18T00:00:00.000Z" }, "expiresAt": { "type": "string", "format": "date-time", "example": "2026-12-01T00:00:00.000Z" } } }, "AuthorizationRegistrationProvenance": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "credentialPublicId", "role", "requestHash", "registeredAt" ], "properties": { "schemaVersion": { "type": "string", "const": "partner-authorization-registration-v2" }, "credentialPublicId": { "type": "string" }, "role": { "type": "string", "enum": [ "claimant_agent", "respondent_agent" ] }, "requestHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "registeredAt": { "type": "string", "format": "date-time" } } }, "ClaimantAuthorizationRegistrationProvenance": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "credentialPublicId", "role", "requestHash", "registeredAt" ], "properties": { "schemaVersion": { "type": "string", "const": "partner-authorization-registration-v2" }, "credentialPublicId": { "type": "string" }, "role": { "type": "string", "const": "claimant_agent" }, "requestHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "registeredAt": { "type": "string", "format": "date-time" } } }, "AuthorityGrantRegistrationResult": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "authorityGrantId", "claimantPrincipalId", "externalCaseId", "transactionId", "allowedActs", "maximumAmount", "expiresAt", "registeredBy" ], "properties": { "schemaVersion": { "type": "string", "const": "partner-authority-grant-v2" }, "authorityGrantId": { "type": "string" }, "claimantPrincipalId": { "type": "string" }, "externalCaseId": { "type": "string" }, "transactionId": { "type": "string" }, "allowedActs": { "type": "array", "items": { "type": "string", "enum": [ "file_dispute", "submit_evidence" ] } }, "maximumAmount": { "$ref": "#/components/schemas/FiatMoney" }, "expiresAt": { "type": "string", "format": "date-time" }, "registeredBy": { "$ref": "#/components/schemas/ClaimantAuthorizationRegistrationProvenance" } } }, "AuthorityGrantRegistrationEnvelope": { "type": "object", "additionalProperties": false, "required": [ "data", "requestId" ], "properties": { "data": { "$ref": "#/components/schemas/AuthorityGrantRegistrationResult" }, "requestId": { "type": "string" } } }, "ConsentArtifactRegistrationResult": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "consentArtifactId", "party", "principalId", "counterpartyId", "transactionId", "scope", "rulesVersion", "termsVersion", "acceptedAt", "expiresAt", "registeredBy" ], "properties": { "schemaVersion": { "type": "string", "const": "partner-consent-artifact-v2" }, "consentArtifactId": { "type": "string" }, "party": { "type": "string", "enum": [ "claimant", "respondent" ] }, "principalId": { "type": "string" }, "counterpartyId": { "type": "string" }, "transactionId": { "type": "string" }, "scope": { "type": "string" }, "rulesVersion": { "type": "string" }, "termsVersion": { "type": "string" }, "acceptedAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": [ "string", "null" ], "format": "date-time" }, "registeredBy": { "$ref": "#/components/schemas/AuthorizationRegistrationProvenance" } } }, "ConsentArtifactRegistrationEnvelope": { "type": "object", "additionalProperties": false, "required": [ "data", "requestId" ], "properties": { "data": { "$ref": "#/components/schemas/ConsentArtifactRegistrationResult" }, "requestId": { "type": "string" } } }, "EvidenceCandidateList": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "caseId", "party", "candidates" ], "properties": { "schemaVersion": { "type": "string", "const": "evidence-candidates-v2" }, "caseId": { "type": "string" }, "party": { "type": "string", "enum": [ "claimant", "respondent" ] }, "candidates": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "exportRecordId", "sourcePartnerId", "adopterPartnerId", "externalExportId", "exportVersion", "receivedAt", "superseded", "artifacts" ], "properties": { "exportRecordId": { "type": "string" }, "sourcePartnerId": { "type": "string" }, "adopterPartnerId": { "type": "string" }, "externalExportId": { "type": "string" }, "exportVersion": { "type": "integer", "minimum": 1 }, "receivedAt": { "type": "string", "format": "date-time" }, "superseded": { "type": "boolean" }, "artifacts": { "type": "array", "items": { "type": "object", "additionalProperties": true, "required": [ "artifactRef", "contentType", "byteLength", "sha256", "adoptable", "adoptedByThisParty" ], "properties": { "artifactRef": { "type": "string" }, "contentType": { "type": "string" }, "byteLength": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "adoptable": { "type": "boolean" }, "adoptedByThisParty": { "type": "boolean" } } } } } } } } }, "PrepareFiling": { "type": "object", "additionalProperties": false, "required": [ "externalCaseId", "transactionId", "policyVersion", "authorityGrantId", "consentArtifactIds", "summary", "claimAmount", "parties", "claim" ], "properties": { "externalCaseId": { "type": "string" }, "transactionId": { "type": "string" }, "policyVersion": { "type": "string" }, "authorityGrantId": { "type": "string" }, "consentArtifactIds": { "$ref": "#/components/schemas/ConsentArtifactIds" }, "summary": { "type": "string" }, "backgroundFacts": { "type": "string" }, "claimAmount": { "$ref": "#/components/schemas/FiatMoney" }, "parties": { "$ref": "#/components/schemas/CasePartiesInput" }, "claim": { "$ref": "#/components/schemas/ClaimInput" }, "metadata": { "type": "object", "additionalProperties": { "type": "string" } } } }, "FilingConfirmation": { "type": "object", "additionalProperties": false, "required": [ "draftDigest", "confirmationStatement", "actorId", "principalId", "confirmationMethod", "confirmationReference" ], "properties": { "draftDigest": { "type": "string", "minLength": 1, "maxLength": 64 }, "confirmationStatement": { "type": "string", "minLength": 1, "maxLength": 1000 }, "actorId": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Must equal the immutable claimant authority agent ID." }, "principalId": { "type": "string", "minLength": 1, "maxLength": 200 }, "confirmationMethod": { "type": "string", "const": "protocol_act" }, "confirmationReference": { "type": "string", "minLength": 1, "maxLength": 500 } } }, "MembershipAnswer": { "type": "object", "additionalProperties": false, "required": [ "protocolActor", "protocolPrincipal", "protocolSource", "position" ], "properties": { "protocolActor": { "type": "string", "minLength": 1, "pattern": "\\S", "description": "Must equal the active respondent membership agent ID, or the authenticated credential public ID when the membership has no immutable agent." }, "protocolPrincipal": { "type": "string", "minLength": 1, "pattern": "\\S" }, "protocolSource": { "type": "string", "minLength": 1, "pattern": "\\S" }, "name": { "type": "string" }, "type": { "type": "string", "enum": [ "human", "entity", "agent" ] }, "position": { "type": "string", "minLength": 1, "maxLength": 20000, "pattern": "\\S" }, "evidence": { "type": "array", "items": { "type": "string" } }, "relief": { "type": "string", "maxLength": 2000 }, "declaratoryRelief": { "type": "string", "maxLength": 4000, "pattern": "^\\s*$|^\\s*[Dd][Ee][Cc][Ll][Aa][Rr][Ee]\\s+[Tt][Hh][Aa][Tt]\\s+\\S" }, "hasPrincipal": { "type": "boolean" }, "principalCompressedClockConsent": { "type": "boolean" } } }, "WalletInviteAnswer": { "type": "object", "additionalProperties": false, "required": [ "inviteToken", "walletAddress", "signature", "position" ], "properties": { "inviteToken": { "type": "string", "minLength": 1 }, "walletAddress": { "type": "string", "pattern": "^0x[A-Fa-f0-9]{40}$" }, "signature": { "type": "string", "pattern": "^0x[A-Fa-f0-9]{130}$" }, "name": { "type": "string" }, "type": { "type": "string", "enum": [ "human", "entity", "agent" ] }, "position": { "type": "string", "minLength": 1, "maxLength": 20000, "pattern": "\\S" }, "evidence": { "type": "array", "items": { "type": "string" } }, "relief": { "type": "string", "maxLength": 2000 }, "declaratoryRelief": { "type": "string", "maxLength": 4000, "pattern": "^\\s*$|^\\s*[Dd][Ee][Cc][Ll][Aa][Rr][Ee]\\s+[Tt][Hh][Aa][Tt]\\s+\\S" }, "hasPrincipal": { "type": "boolean" }, "principalCompressedClockConsent": { "type": "boolean" } } }, "Answer": { "oneOf": [ { "$ref": "#/components/schemas/MembershipAnswer" }, { "$ref": "#/components/schemas/WalletInviteAnswer" } ] }, "TerminationRequestInput": { "type": "object", "additionalProperties": false, "required": [ "action", "expectedRevision" ], "properties": { "action": { "type": "string", "enum": [ "request", "cancel_request" ] }, "expectedRevision": { "type": "integer", "minimum": 0 }, "requestId": { "type": "string", "description": "Required when action is cancel_request." }, "adoption": { "$ref": "#/components/schemas/RulesAdoptionAssent" }, "externalProtocolReference": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,200}$", "description": "Required when action is request; identifies the agent protocol act without exposing settlement terms." } } }, "RulesAdoptionAssent": { "type": "object", "additionalProperties": false, "required": [ "version", "hash", "statementVersion" ], "properties": { "version": { "type": "string" }, "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "statementVersion": { "type": "string", "const": "rule_1_3_adoption_v1" } } }, "PreAwardTermination": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "id", "kind", "status", "initiatedBySide", "initiatedAt", "confirmations", "fundsEffect" ], "properties": { "schemaVersion": { "type": "string", "const": "pre-award-termination-v1" }, "id": { "type": "string" }, "kind": { "type": "string", "enum": [ "claimant_withdrawal", "party_agreement" ] }, "status": { "type": "string", "enum": [ "pending", "completed", "cancelled", "superseded" ] }, "initiatedBySide": { "type": "string", "enum": [ "claimant", "respondent" ] }, "initiatedAt": { "type": "string", "format": "date-time" }, "confirmations": { "type": "array", "maxItems": 2, "items": { "type": "object", "additionalProperties": false, "required": [ "side", "confirmedAt" ], "properties": { "side": { "type": "string", "enum": [ "claimant", "respondent" ] }, "confirmedAt": { "type": "string", "format": "date-time" } } } }, "completedAt": { "type": "string", "format": "date-time" }, "cancelledAt": { "type": "string", "format": "date-time" }, "fundsEffect": { "type": "string", "const": "none" }, "adoptsRulesVersion": { "type": "string" }, "adoptsRulesHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } }, "PreAwardTerminationResponse": { "type": "object", "additionalProperties": false, "required": [ "data", "requestId" ], "properties": { "data": { "type": "object", "additionalProperties": false, "required": [ "caseId", "caseStatus", "revision", "termination" ], "properties": { "caseId": { "type": "string" }, "caseStatus": { "type": "string" }, "revision": { "type": "integer", "minimum": 0 }, "termination": { "$ref": "#/components/schemas/PreAwardTermination" }, "deadlinesContinue": { "type": "boolean" } } }, "requestId": { "type": "string" } } }, "EvidenceExportNotification": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "eventId", "eventType", "occurredAt", "exporterId", "specVersion", "exportId", "exportVersion", "bundleHash", "contentType", "byteLength", "downloadUrl", "downloadExpiresAt", "match" ], "properties": { "schemaVersion": { "type": "string", "const": "evidence-export-notification-v1" }, "eventId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,160}$" }, "eventType": { "type": "string", "const": "evidence.bundle.available" }, "occurredAt": { "type": "string", "format": "date-time", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$" }, "exporterId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,200}$" }, "specVersion": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,200}$" }, "exportId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,200}$" }, "exportVersion": { "type": "integer", "minimum": 1 }, "supersedes": { "type": "object", "additionalProperties": false, "required": [ "exportId", "exportVersion", "sha256" ], "properties": { "exportId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,200}$" }, "exportVersion": { "type": "integer", "minimum": 1 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } }, "bundleHash": { "type": "object", "additionalProperties": false, "required": [ "algorithm", "value" ], "properties": { "algorithm": { "type": "string", "const": "sha256" }, "value": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } }, "contentType": { "type": "string", "const": "application/json" }, "byteLength": { "type": "integer", "minimum": 1, "maximum": 10485760 }, "downloadUrl": { "type": "string", "format": "uri", "maxLength": 2048, "pattern": "^https://(?![^/?#]*@)(?:[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?\\.)*[A-Za-z](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?(?::(?:0|[1-9][0-9]{0,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?(?:[/?][^#\\s]*)?$", "description": "HTTPS URL with a conventional DNS hostname whose final label begins with an ASCII letter, an optional canonical decimal port from 0 through 65535, and no user information or fragment. IP literals and other WHATWG normalization forms are intentionally outside this conservative published schema; runtime URL parsing remains authoritative." }, "downloadExpiresAt": { "type": "string", "format": "date-time", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$" }, "match": { "type": "object", "additionalProperties": false, "minProperties": 1, "properties": { "externalCaseId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,200}$" }, "transactionId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,200}$" }, "merchantId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,200}$" }, "network": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,200}$" }, "transactionHash": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,200}$" } } }, "retention": { "type": "object", "additionalProperties": false, "properties": { "profileId": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,200}$" }, "sourceRetentionUntil": { "type": "string", "format": "date-time", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$" }, "sourceLegalHoldActive": { "type": "boolean" } } } } }, "CreateCaseDraft": { "type": "object", "additionalProperties": false, "required": [ "externalCaseId", "transactionId", "policyVersion", "authorityGrantId", "consentArtifactIds", "claimAmount", "parties", "intakeMode", "confirmationPolicy" ], "properties": { "caseMode": { "type": "string", "enum": [ "proceeding", "evaluation" ], "default": "proceeding" }, "externalCaseId": { "type": "string" }, "transactionId": { "type": "string" }, "policyVersion": { "type": "string" }, "authorityGrantId": { "type": "string" }, "consentArtifactIds": { "$ref": "#/components/schemas/CaseDraftConsentArtifactIds" }, "claimAmount": { "$ref": "#/components/schemas/FiatMoney" }, "parties": { "$ref": "#/components/schemas/CasePartiesInput" }, "summary": { "type": "string" }, "backgroundFacts": { "type": "string" }, "claim": { "$ref": "#/components/schemas/ClaimInput" }, "metadata": { "type": "object", "additionalProperties": { "type": "string" } }, "intakeMode": { "type": "string", "enum": [ "claimant_initiated", "claimant_proposed", "bilateral_api", "bundled_bilateral" ] }, "confirmationPolicy": { "type": "object", "additionalProperties": false, "required": [ "mode" ], "properties": { "mode": { "type": "string", "enum": [ "initiator_only", "all_participants", "bundled_authorizations" ] } } }, "procedure": { "$ref": "#/components/schemas/CaseProcedure" }, "evaluation": { "$ref": "#/components/schemas/NarrowEvaluationDefinitionInput" }, "participants": { "type": "array", "minItems": 2, "maxItems": 2, "items": { "type": "object", "additionalProperties": false, "required": [ "side" ], "properties": { "side": { "type": "string", "enum": [ "claimant", "respondent" ] }, "partnerId": { "type": "string", "description": "Required for API-authorized participants. Omit it for the hosted respondent in claimant_initiated mode." }, "agentId": { "type": "string" } } } } }, "allOf": [ { "oneOf": [ { "title": "Claimant initiates and respondent may consent later", "properties": { "intakeMode": { "type": "string", "const": "claimant_initiated" } }, "oneOf": [ { "title": "Hosted respondent consents after opening", "properties": { "consentArtifactIds": { "$ref": "#/components/schemas/ClaimantOnlyConsentArtifactIds" }, "participants": { "$ref": "#/components/schemas/HostedCaseDraftParticipants" } } }, { "title": "Respondent consent was registered in advance", "properties": { "consentArtifactIds": { "$ref": "#/components/schemas/ConsentArtifactIds" } } } ] }, { "title": "Bilaterally authorized or claimant-proposed case", "properties": { "intakeMode": { "type": "string", "enum": [ "claimant_proposed", "bilateral_api", "bundled_bilateral" ] }, "consentArtifactIds": { "$ref": "#/components/schemas/ConsentArtifactIds" } } } ] } ], "oneOf": [ { "title": "Proceeding case", "required": [ "summary", "claim" ], "properties": { "caseMode": { "type": "string", "const": "proceeding" } } }, { "title": "Narrow evaluation case", "required": [ "caseMode", "evaluation" ], "properties": { "caseMode": { "type": "string", "const": "evaluation" } } } ] }, "ConsentArtifactIds": { "type": "object", "additionalProperties": false, "required": [ "claimant", "respondent" ], "properties": { "claimant": { "type": "string" }, "respondent": { "type": "string" } } }, "CaseDraftConsentArtifactIds": { "type": "object", "additionalProperties": false, "required": [ "claimant" ], "properties": { "claimant": { "type": "string" }, "respondent": { "type": "string", "description": "May be omitted only for claimant_initiated; the respondent then accepts the immutable case terms in the hosted flow." } } }, "ClaimantOnlyConsentArtifactIds": { "type": "object", "additionalProperties": false, "required": [ "claimant" ], "properties": { "claimant": { "type": "string" } } }, "HostedCaseDraftParticipants": { "type": "array", "minItems": 2, "maxItems": 2, "items": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "side" ], "properties": { "side": { "type": "string", "const": "claimant" }, "partnerId": { "type": "string" }, "agentId": { "type": "string" } } }, { "type": "object", "additionalProperties": false, "required": [ "side" ], "properties": { "side": { "type": "string", "const": "respondent" } } } ] } }, "CasePartyInput": { "type": "object", "additionalProperties": false, "required": [ "externalId", "name" ], "properties": { "externalId": { "type": "string" }, "name": { "type": "string" } } }, "CasePartiesInput": { "type": "object", "additionalProperties": false, "required": [ "claimant", "respondent" ], "properties": { "claimant": { "$ref": "#/components/schemas/CasePartyInput" }, "respondent": { "$ref": "#/components/schemas/CasePartyInput" } } }, "ClaimInput": { "type": "object", "additionalProperties": false, "required": [ "statement", "requestedOutcome" ], "properties": { "statement": { "type": "string" }, "requestedOutcome": { "type": "string", "enum": [ "refund", "release", "split", "other" ] } } }, "CaseProcedure": { "type": "object", "additionalProperties": false, "required": [ "profile" ], "properties": { "profile": { "type": "string", "enum": [ "standard", "fast", "single_round", "joint_record", "evaluation", "custom_bounded" ] }, "answerRequired": { "type": "boolean" }, "evidenceRounds": { "type": "integer", "minimum": 1, "maximum": 3 }, "rebuttalRounds": { "type": "integer", "minimum": 0, "maximum": 3 }, "filingsPerSidePerStage": { "type": "integer", "minimum": 1, "maximum": 3 }, "recordConfirmationRequired": { "type": "boolean", "const": true } } }, "NarrowEvaluationCriterion": { "type": "object", "additionalProperties": false, "required": [ "id", "text" ], "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,63}$" }, "text": { "type": "string", "minLength": 1, "maxLength": 1000 } } }, "NarrowEvaluationOutcome": { "type": "object", "additionalProperties": false, "required": [ "code", "settlementAction" ], "properties": { "code": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,63}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 200 }, "settlementAction": { "type": "object", "additionalProperties": false, "required": [ "type" ], "properties": { "type": { "type": "string", "enum": [ "release_to_claimant", "release_to_respondent", "allocate_by_award", "none" ] } } } } }, "NarrowEvaluationDefinitionInput": { "type": "object", "additionalProperties": false, "required": [ "externalEvaluationId", "question", "allowedOutcomes" ], "properties": { "externalEvaluationId": { "type": "string", "minLength": 1, "maxLength": 200 }, "question": { "type": "object", "additionalProperties": false, "required": [ "text", "criteria" ], "properties": { "text": { "type": "string", "minLength": 1, "maxLength": 2000 }, "criteria": { "type": "array", "minItems": 1, "maxItems": 20, "items": { "$ref": "#/components/schemas/NarrowEvaluationCriterion" } } } }, "allowedOutcomes": { "type": "array", "minItems": 3, "maxItems": 3, "description": "Exactly three outcomes are required; indeterminate must be the single outcome mapped to none. The other outcomes may use full release or exact Award allocation.", "items": { "$ref": "#/components/schemas/NarrowEvaluationOutcome" } }, "evidencePolicy": { "$ref": "#/components/schemas/NarrowEvaluationEvidencePolicyInput" }, "reviewPolicy": { "$ref": "#/components/schemas/NarrowEvaluationReviewPolicyInput" } } }, "CaseDraftEvaluationDefinition": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "externalEvaluationId", "evaluationDigest", "question", "allowedOutcomes", "evidencePolicy", "reviewPolicy" ], "properties": { "schemaVersion": { "type": "string", "const": "narrow-evaluation-v2" }, "externalEvaluationId": { "type": "string" }, "evaluationDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "question": { "type": "object", "additionalProperties": false, "required": [ "text", "criteria" ], "properties": { "text": { "type": "string" }, "criteria": { "type": "array", "items": { "$ref": "#/components/schemas/NarrowEvaluationCriterion" } } } }, "allowedOutcomes": { "type": "array", "items": { "$ref": "#/components/schemas/NarrowEvaluationOutcome" } }, "evidencePolicy": { "$ref": "#/components/schemas/NarrowEvaluationEvidencePolicy" }, "reviewPolicy": { "$ref": "#/components/schemas/NarrowEvaluationReviewPolicy" } } }, "NarrowEvaluationEvidencePolicyInput": { "type": "object", "additionalProperties": false, "properties": { "sources": { "type": "array", "minItems": 1, "maxItems": 2, "uniqueItems": true, "items": { "type": "string", "enum": [ "party_submissions", "evidence_export_candidates" ] } }, "additionalPartyEvidence": { "type": "boolean", "const": true, "default": true } } }, "NarrowEvaluationReviewPolicyInput": { "type": "object", "additionalProperties": false, "properties": { "initialPath": { "type": "string", "const": "adjudicative", "default": "adjudicative" }, "humanReviewRequired": { "type": "boolean", "const": false, "default": false } } }, "NarrowEvaluationEvidencePolicy": { "type": "object", "additionalProperties": false, "required": [ "sources", "additionalPartyEvidence" ], "properties": { "sources": { "type": "array", "minItems": 1, "maxItems": 2, "uniqueItems": true, "items": { "type": "string", "enum": [ "party_submissions", "evidence_export_candidates" ] } }, "additionalPartyEvidence": { "type": "boolean", "const": true } } }, "NarrowEvaluationReviewPolicy": { "type": "object", "additionalProperties": false, "required": [ "initialPath", "humanReviewRequired" ], "properties": { "initialPath": { "type": "string", "const": "adjudicative" }, "humanReviewRequired": { "type": "boolean", "const": false } } }, "NarrowEvaluationRecord": { "type": "object", "additionalProperties": false, "required": [ "status" ], "properties": { "phase": { "type": "string", "enum": [ "evidence", "close", "merits" ] }, "status": { "type": "string", "enum": [ "open", "frozen" ] } } }, "NarrowEvaluationCriterionFinding": { "type": "object", "additionalProperties": false, "required": [ "criterionId", "status", "finding", "confidence" ], "properties": { "criterionId": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,63}$" }, "status": { "type": "string", "enum": [ "satisfied", "not_satisfied", "indeterminate" ] }, "finding": { "type": "string" }, "confidence": { "type": "number", "minimum": 0, "maximum": 1 } } }, "NarrowEvaluationAwardReference": { "type": "object", "additionalProperties": false, "required": [ "dispositionId", "awardHash", "resourcePath" ], "properties": { "dispositionId": { "type": "string" }, "awardHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "releasedAt": { "type": "string", "format": "date-time" }, "resourcePath": { "type": "string" } } }, "NarrowEvaluationPendingResult": { "type": "object", "additionalProperties": false, "required": [ "status", "finality" ], "properties": { "status": { "type": "string", "enum": [ "pending", "under_review" ] }, "finality": { "type": "string", "const": "not_served" } } }, "NarrowEvaluationServedResult": { "type": "object", "additionalProperties": false, "required": [ "status", "finality", "outcomeCode", "settlementAction", "criterionFindings", "determinations", "award" ], "properties": { "status": { "type": "string", "const": "served" }, "finality": { "type": "string", "enum": [ "served", "appealable", "appeal_reserved", "appeal_pending", "final" ] }, "outcomeCode": { "type": "string" }, "settlementAction": { "type": "object", "additionalProperties": false, "required": [ "type" ], "properties": { "type": { "type": "string", "enum": [ "release_to_claimant", "release_to_respondent", "allocate_by_award", "none" ] } } }, "criterionFindings": { "type": "array", "minItems": 1, "maxItems": 20, "items": { "$ref": "#/components/schemas/NarrowEvaluationCriterionFinding" } }, "determinations": { "type": "object", "additionalProperties": true }, "award": { "$ref": "#/components/schemas/NarrowEvaluationAwardReference" } } }, "NarrowEvaluationResource": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "caseId", "externalCaseId", "externalEvaluationId", "evaluationDigest", "question", "allowedOutcomes", "evidencePolicy", "reviewPolicy", "record", "result" ], "properties": { "schemaVersion": { "type": "string", "const": "narrow-evaluation-resource-v2" }, "caseId": { "type": "string" }, "externalCaseId": { "type": "string" }, "externalEvaluationId": { "type": "string" }, "evaluationDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "question": { "type": "object", "additionalProperties": false, "required": [ "text", "criteria" ], "properties": { "text": { "type": "string" }, "criteria": { "type": "array", "minItems": 1, "maxItems": 20, "items": { "$ref": "#/components/schemas/NarrowEvaluationCriterion" } } } }, "allowedOutcomes": { "type": "array", "items": { "$ref": "#/components/schemas/NarrowEvaluationOutcome" } }, "evidencePolicy": { "$ref": "#/components/schemas/NarrowEvaluationEvidencePolicy" }, "reviewPolicy": { "$ref": "#/components/schemas/NarrowEvaluationReviewPolicy" }, "record": { "$ref": "#/components/schemas/NarrowEvaluationRecord" }, "result": { "oneOf": [ { "$ref": "#/components/schemas/NarrowEvaluationPendingResult" }, { "$ref": "#/components/schemas/NarrowEvaluationServedResult" } ], "discriminator": { "propertyName": "status" } } } }, "NarrowEvaluationAcceptanceInput": { "type": "object", "additionalProperties": false, "required": [ "inviteToken", "principalId", "actorId", "confirmationStatement", "confirmationReference" ], "properties": { "inviteToken": { "type": "string" }, "principalId": { "type": "string" }, "actorId": { "type": "string" }, "confirmationStatement": { "type": "string", "description": "Copy the exact confirmationStatement returned by the respondent handoff; do not reconstruct or rewrite it." }, "confirmationReference": { "type": "string" } } }, "NarrowEvaluationAcceptance": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "caseId", "externalEvaluationId", "evaluationDigest", "accepted", "status", "evaluationPath", "capabilityDelivery" ], "properties": { "schemaVersion": { "type": "string", "const": "narrow-evaluation-acceptance-v2" }, "caseId": { "type": "string" }, "externalEvaluationId": { "type": "string" }, "evaluationDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "accepted": { "type": "boolean", "const": true }, "status": { "type": "string", "const": "awaiting_party_submissions" }, "evaluationPath": { "type": "string" }, "capabilityDelivery": { "type": "string", "const": "show_once_not_replayed" }, "showOnce": { "type": "object", "additionalProperties": false, "required": [ "respondentPartyToken" ], "properties": { "respondentPartyToken": { "type": "string" } } } } }, "PartnerAuthenticityChallengeInput": { "type": "object", "additionalProperties": false, "required": [ "ground" ], "properties": { "ground": { "type": "string", "minLength": 1, "maxLength": 4096, "description": "Plain party text. Sanitizer quarantine causes the request to fail without a write." } } }, "PartnerAuthenticityChallenge": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "caseId", "evidenceId", "challenge", "recordEffect", "resolutionAuthority" ], "properties": { "schemaVersion": { "type": "string", "const": "partner-authenticity-challenge-v2" }, "caseId": { "type": "string" }, "evidenceId": { "type": "string" }, "challenge": { "type": "object", "additionalProperties": false, "required": [ "byParty", "ground", "raisedAt", "status" ], "properties": { "byParty": { "type": "string", "enum": [ "claimant", "respondent" ] }, "ground": { "type": "string" }, "raisedAt": { "type": "string", "format": "date-time" }, "status": { "type": "string", "enum": [ "raised", "sustained", "overruled" ] }, "resolvedAt": { "type": "string", "format": "date-time" }, "resolvedBy": { "type": "string" } } }, "recordEffect": { "type": "string", "const": "contested_weight_only" }, "resolutionAuthority": { "type": "string", "enum": [ "assigned_reviewer_only", "assigned_tribunal" ], "description": "Current Rules use the assigned AI Tribunal; historical cases retain their pinned assigned-reviewer authority." } } }, "PartnerAuthenticityChallengeList": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "caseId", "evidenceId", "challenges", "recordEffect", "resolutionAuthority" ], "properties": { "schemaVersion": { "type": "string", "const": "partner-authenticity-challenge-list-v2" }, "caseId": { "type": "string" }, "evidenceId": { "type": "string" }, "challenges": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "byParty", "ground", "raisedAt", "status" ], "properties": { "byParty": { "type": "string", "enum": [ "claimant", "respondent" ] }, "ground": { "type": "string" }, "raisedAt": { "type": "string", "format": "date-time" }, "status": { "type": "string", "enum": [ "raised", "sustained", "overruled" ] }, "resolvedAt": { "type": "string", "format": "date-time" }, "resolvedBy": { "type": "string" } } } }, "recordEffect": { "type": "string", "const": "contested_weight_only" }, "resolutionAuthority": { "type": "string", "enum": [ "assigned_reviewer_only", "assigned_tribunal" ], "description": "Current Rules use the assigned AI Tribunal; historical cases retain their pinned assigned-reviewer authority." } } }, "PartnerAwardArtifactAttestation": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "case", "artifact", "source", "attestationDigest", "signature" ], "properties": { "schemaVersion": { "type": "string", "const": "partner-award-artifact-attestation-v2" }, "case": { "type": "object", "additionalProperties": false, "required": [ "caseId", "externalCaseId" ], "properties": { "caseId": { "type": "string" }, "externalCaseId": { "type": "string" } } }, "artifact": { "type": "object", "additionalProperties": false, "required": [ "artifactId", "schemaVersion", "mediaType", "byteLength", "sha256" ], "properties": { "artifactId": { "type": "string", "pattern": "^pav2_" }, "schemaVersion": { "type": "string", "const": "award-decision-v2" }, "mediaType": { "type": "string", "const": "application/json" }, "byteLength": { "type": "integer", "minimum": 1 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } }, "source": { "type": "object", "additionalProperties": false, "required": [ "awardHash", "dispositionId", "awardRevision", "artifactSha256", "artifacts" ], "properties": { "awardHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "dispositionId": { "type": "string" }, "awardRevision": { "type": "integer", "minimum": 1 }, "artifactSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "artifacts": { "type": "array", "description": "Exactly one descriptor for each frozen source kind: pdf, docx, and json.", "minItems": 3, "maxItems": 3, "items": { "type": "object", "additionalProperties": false, "required": [ "artifactId", "kind", "mediaType", "byteLength", "sha256" ], "properties": { "artifactId": { "type": "string" }, "kind": { "type": "string", "enum": [ "pdf", "docx", "json" ] }, "mediaType": { "type": "string" }, "byteLength": { "type": "integer", "minimum": 1 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } } } } }, "attestationDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "signature": { "type": "object", "additionalProperties": false, "required": [ "signature", "signerAddress", "algorithm", "signedAt", "signedHash" ], "properties": { "signature": { "type": "string" }, "signerAddress": { "type": "string", "pattern": "^0x[a-fA-F0-9]{40}$" }, "algorithm": { "type": "string", "const": "eip191" }, "signedAt": { "type": "string", "format": "date-time" }, "signedHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } } } }, "PartnerCaseRecordBundleManifest": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "recipe", "partnerId", "caseId", "externalCaseId", "caseRevision", "profile", "partySide", "sourceSnapshotHash", "snapshotAt", "rules", "files", "exclusions", "bundleId", "bundleHash" ], "properties": { "schemaVersion": { "type": "string", "const": "case-record-bundle-v2" }, "recipe": { "type": "string", "const": "sha256-canonical-json-v2" }, "partnerId": { "type": "string" }, "caseId": { "type": "string" }, "externalCaseId": { "type": "string" }, "caseRevision": { "type": "integer", "minimum": 1 }, "dispositionId": { "type": "string" }, "awardRevision": { "type": "integer", "minimum": 1 }, "profile": { "type": "string", "const": "party" }, "partySide": { "type": "string", "enum": [ "claimant", "respondent" ] }, "sourceSnapshotHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "snapshotAt": { "type": "string", "format": "date-time" }, "rules": { "type": "object", "additionalProperties": false, "properties": { "version": { "type": "string" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } }, "files": { "type": "array", "minItems": 3, "items": { "type": "object", "additionalProperties": false, "required": [ "path", "mediaType", "byteLength", "sha256", "category" ], "properties": { "path": { "type": "string" }, "mediaType": { "type": "string" }, "byteLength": { "type": "integer", "minimum": 1 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "sourceSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "sourceId": { "type": "string" }, "category": { "type": "string" } } } }, "exclusions": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "code", "detail" ], "properties": { "code": { "type": "string" }, "sourceId": { "type": "string" }, "detail": { "type": "string" } } } }, "bundleId": { "type": "string", "pattern": "^crb2_[a-f0-9]{64}$" }, "bundleHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } }, "PartnerCaseRecordBundleAttestation": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "partnerId", "caseId", "externalCaseId", "partySide", "caseRevision", "bundleId", "bundleHash", "rules", "files", "attestationDigest", "signature" ], "properties": { "schemaVersion": { "type": "string", "const": "partner-case-record-bundle-attestation-v2" }, "partnerId": { "type": "string" }, "caseId": { "type": "string" }, "externalCaseId": { "type": "string" }, "partySide": { "type": "string", "enum": [ "claimant", "respondent" ] }, "caseRevision": { "type": "integer", "minimum": 1 }, "bundleId": { "type": "string", "pattern": "^crb2_[a-f0-9]{64}$" }, "bundleHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "rules": { "type": "object", "additionalProperties": false, "properties": { "version": { "type": "string" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } }, "files": { "type": "array", "minItems": 3, "items": { "type": "object", "additionalProperties": false, "required": [ "path", "mediaType", "byteLength", "sha256" ], "properties": { "path": { "type": "string" }, "mediaType": { "type": "string" }, "byteLength": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } } }, "attestationDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "signature": { "type": "object", "additionalProperties": false, "required": [ "signature", "signerAddress", "algorithm", "signedAt", "signedHash" ], "properties": { "signature": { "type": "string" }, "signerAddress": { "type": "string", "pattern": "^0x[a-fA-F0-9]{40}$" }, "algorithm": { "type": "string", "const": "eip191" }, "signedAt": { "type": "string", "format": "date-time" }, "signedHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } } } }, "PartnerProceduralMessageInput": { "type": "object", "additionalProperties": false, "required": [ "category", "text" ], "properties": { "category": { "type": "string", "enum": [ "clarification_request", "clarification_response", "evidence_request", "procedural_notice", "settlement_coordination" ] }, "text": { "type": "string", "minLength": 1, "maxLength": 2000, "description": "Plain text, limited to 2,000 UTF-8 bytes. Control characters other than tab and line breaks are rejected." }, "replyToMessageId": { "type": "string", "minLength": 1, "maxLength": 200 }, "evidenceIds": { "type": "array", "maxItems": 8, "uniqueItems": true, "default": [], "description": "References to existing evidence-system objects in this case. No admission or merits-record effect follows.", "items": { "type": "string", "minLength": 1, "maxLength": 200 } } }, "allOf": [ { "if": { "properties": { "category": { "const": "clarification_response" } } }, "then": { "required": [ "replyToMessageId" ] } } ] }, "PartnerProceduralMessage": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "id", "caseId", "partnerId", "senderKind", "senderCredentialPublicId", "category", "text", "evidenceIds", "messageDigest", "recordEffect", "createdAt" ], "properties": { "schemaVersion": { "type": "string", "const": "partner-procedural-message-v2" }, "id": { "type": "string" }, "caseId": { "type": "string" }, "partnerId": { "type": "string" }, "senderKind": { "type": "string", "enum": [ "party", "platform" ] }, "senderSide": { "type": "string", "enum": [ "claimant", "respondent" ] }, "senderCredentialPublicId": { "type": "string", "description": "Public credential identity; the internal persistence identifier is never returned." }, "category": { "type": "string", "enum": [ "clarification_request", "clarification_response", "evidence_request", "procedural_notice", "settlement_coordination" ] }, "text": { "type": "string", "minLength": 1, "maxLength": 2000 }, "replyToMessageId": { "type": "string", "minLength": 1, "maxLength": 200 }, "evidenceIds": { "type": "array", "maxItems": 8, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "messageDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "recordEffect": { "type": "string", "const": "none" }, "createdAt": { "type": "string", "format": "date-time" } } }, "PartnerSettlementCorpus": { "type": "object", "additionalProperties": false, "required": [ "currency", "amountMinorUnits", "claimantPrincipalId", "respondentPrincipalId", "expiresAt" ], "properties": { "currency": { "type": "string", "const": "USD" }, "amountMinorUnits": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "claimantPrincipalId": { "type": "string" }, "respondentPrincipalId": { "type": "string" }, "expiresAt": { "type": "string", "format": "date-time" } } }, "PartnerSettlementBindingInput": { "type": "object", "additionalProperties": false, "required": [ "evaluationDigest", "externalReference", "adapter", "mode", "allowedActions", "corpus" ], "properties": { "evaluationDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "externalReference": { "type": "string", "minLength": 1, "maxLength": 500 }, "adapter": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,200}$" }, "mode": { "type": "string", "enum": [ "manual_partner", "partner_callback", "platform_adapter" ] }, "allowedActions": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "release_to_claimant", "release_to_respondent", "allocate_by_award", "none" ] } }, "corpus": { "$ref": "#/components/schemas/PartnerSettlementCorpus" } } }, "PartnerSettlementBinding": { "type": "object", "additionalProperties": false, "required": [ "id", "partnerId", "caseId", "evaluationDigest", "externalReference", "adapter", "mode", "allowedActions", "corpus", "authority", "bindingDigest", "status", "createdAt" ], "properties": { "id": { "type": "string" }, "partnerId": { "type": "string" }, "caseId": { "type": "string" }, "evaluationDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "externalReference": { "type": "string", "minLength": 1, "maxLength": 500 }, "adapter": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,200}$" }, "mode": { "type": "string", "enum": [ "manual_partner", "partner_callback", "platform_adapter" ] }, "allowedActions": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "release_to_claimant", "release_to_respondent", "allocate_by_award", "none" ] } }, "corpus": { "$ref": "#/components/schemas/PartnerSettlementCorpus" }, "authority": { "$ref": "#/components/schemas/PartnerSettlementBindingAuthority" }, "bindingDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$", "description": "SHA-256 binding the caller-supplied corpus contract and the server-derived immutable authority metadata." }, "status": { "type": "string", "enum": [ "active", "expired", "revoked" ] }, "createdAt": { "type": "string", "format": "date-time" } } }, "PartnerSettlementBindingAuthority": { "type": "object", "additionalProperties": false, "required": [ "actorCredentialPublicId", "actorPrincipalId", "representedPrincipalId", "actorRole", "authorityGrantId", "requiredScope", "authorityAct", "authorizedAt" ], "properties": { "actorCredentialPublicId": { "type": "string" }, "actorPrincipalId": { "type": "string" }, "representedPrincipalId": { "type": "string" }, "actorRole": { "type": "string", "const": "platform_orchestrator" }, "authorityGrantId": { "type": "string" }, "requiredScope": { "type": "string", "const": "settlement:bindings:manage" }, "authorityAct": { "type": "string", "const": "settle_dispute" }, "authorizedAt": { "type": "string", "format": "date-time" } } }, "PartnerSettlementExecutionInput": { "type": "object", "additionalProperties": false, "required": [ "bindingDigest" ], "properties": { "bindingDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "dryRun": { "type": "boolean", "default": false } } }, "PartnerSettlementAllocation": { "type": "object", "additionalProperties": false, "required": [ "recipient", "principalId", "amountMinorUnits" ], "properties": { "recipient": { "type": "string", "enum": [ "claimant", "respondent" ] }, "principalId": { "type": "string" }, "amountMinorUnits": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" } } }, "PartnerSettlementAttempt": { "type": "object", "additionalProperties": false, "required": [ "id", "partnerId", "caseId", "bindingId", "bindingDigest", "evaluationDigest", "dispositionId", "awardRevision", "awardHash", "outcomeCode", "action", "amountMinorUnits", "allocations", "currency", "dryRun", "status", "createdAt" ], "properties": { "id": { "type": "string" }, "partnerId": { "type": "string" }, "caseId": { "type": "string" }, "bindingId": { "type": "string" }, "operationId": { "type": "string" }, "operationKey": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "bindingDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "evaluationDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "dispositionId": { "type": "string" }, "awardRevision": { "type": "integer", "minimum": 0 }, "awardHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "outcomeCode": { "type": "string" }, "action": { "type": "string", "enum": [ "release_to_claimant", "release_to_respondent", "allocate_by_award", "none" ] }, "amountMinorUnits": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "allocations": { "type": "array", "maxItems": 2, "items": { "$ref": "#/components/schemas/PartnerSettlementAllocation" } }, "currency": { "type": "string", "const": "USD" }, "dryRun": { "type": "boolean" }, "status": { "type": "string", "enum": [ "validated", "manual_action_required", "callback_required", "completed", "failed", "blocked", "unknown_outcome" ] }, "adapterReceipt": { "type": "object", "additionalProperties": { "type": "string" } }, "failureCode": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" } } }, "PartnerSettlementOperation": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "id", "operationKey", "providerIdempotencyKey", "partnerId", "caseId", "bindingId", "bindingDigest", "dispositionId", "awardRevision", "awardHash", "outcomeCode", "action", "amountMinorUnits", "allocations", "currency", "adapter", "externalReference", "status", "createdAt", "updatedAt" ], "properties": { "schemaVersion": { "type": "string", "const": "partner-settlement-operation-v2" }, "id": { "type": "string" }, "operationKey": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "providerIdempotencyKey": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "partnerId": { "type": "string" }, "caseId": { "type": "string" }, "bindingId": { "type": "string" }, "bindingDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "dispositionId": { "type": "string" }, "awardRevision": { "type": "integer", "minimum": 0 }, "awardHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "outcomeCode": { "type": "string" }, "action": { "type": "string", "enum": [ "release_to_claimant", "release_to_respondent", "allocate_by_award", "none" ] }, "amountMinorUnits": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,77})$" }, "allocations": { "type": "array", "maxItems": 2, "items": { "$ref": "#/components/schemas/PartnerSettlementAllocation" } }, "currency": { "type": "string", "const": "USD" }, "adapter": { "type": "string" }, "externalReference": { "type": "string" }, "status": { "type": "string", "enum": [ "prepared", "submitting", "unknown_outcome", "manual_action_required", "callback_required", "completed", "failed", "blocked" ] }, "adapterReceipt": { "type": "object", "additionalProperties": { "type": "string" } }, "failureCode": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } } }, "PartnerWebhookEndpointInput": { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "maxLength": 2000 }, "rotateFromEndpointId": { "type": "string" }, "overlapSeconds": { "type": "integer", "minimum": 60, "maximum": 86400 } }, "dependentRequired": { "rotateFromEndpointId": [ "overlapSeconds" ], "overlapSeconds": [ "rotateFromEndpointId" ] } }, "PartnerWebhookDeliveryAttempt": { "type": "object", "additionalProperties": false, "required": [ "attemptNumber", "status", "keyId", "signedAt" ], "properties": { "attemptNumber": { "type": "integer", "minimum": 1 }, "status": { "type": "string", "enum": [ "prepared", "delivered", "retryable_failure", "terminal_failure" ] }, "responseStatus": { "type": "integer" }, "errorCode": { "type": "string" }, "keyId": { "type": "string" }, "signedAt": { "type": "string", "format": "date-time" }, "completedAt": { "type": "string", "format": "date-time" } } }, "PartnerWebhookDelivery": { "type": "object", "additionalProperties": false, "required": [ "eventId", "deliveryId", "sequence", "caseId", "type", "occurredAt", "status", "attempts", "deliveryAttempts" ], "properties": { "eventId": { "type": "string" }, "deliveryId": { "type": "string" }, "sequence": { "type": "integer", "minimum": 1 }, "caseId": { "type": "string" }, "type": { "type": "string" }, "occurredAt": { "type": "string", "format": "date-time" }, "endpointId": { "type": "string" }, "status": { "type": "string", "enum": [ "pending", "sending", "delivered", "failed", "suppressed", "dead_letter" ] }, "attempts": { "type": "integer", "minimum": 0 }, "nextAttemptAt": { "type": "string", "format": "date-time" }, "deadLetteredAt": { "type": "string", "format": "date-time" }, "replayOfDeliveryId": { "type": "string" }, "deliveredAt": { "type": "string", "format": "date-time" }, "lastError": { "type": "string" }, "deliveryAttempts": { "type": "array", "items": { "$ref": "#/components/schemas/PartnerWebhookDeliveryAttempt" } } } }, "CaseDraftConfirmation": { "type": "object", "additionalProperties": false, "required": [ "participantId", "draftDigest", "confirmationStatement", "actorId", "principalId", "confirmationMethod", "confirmationReference" ], "properties": { "participantId": { "type": "string" }, "draftDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "confirmationStatement": { "type": "string", "description": "Copy the exact confirmationStatement returned for this participant by GET /api/v2/case-drafts/{draftId}; do not reconstruct or rewrite it." }, "actorId": { "type": "string", "description": "Must equal the participant's immutable agent ID, or the authenticated credential public ID when that participant has no immutable agent." }, "principalId": { "type": "string" }, "confirmationMethod": { "type": "string", "const": "protocol_act" }, "confirmationReference": { "type": "string" } } }, "CaseDraftRulesStamp": { "type": "object", "additionalProperties": false, "required": [ "version", "hash" ], "properties": { "version": { "type": "string" }, "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } }, "ResolvedCaseProcedure": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "profile", "answerRequired", "evidenceRounds", "rebuttalRounds", "filingsPerSidePerStage", "recordConfirmationRequired" ], "properties": { "schemaVersion": { "type": "string", "const": "case-procedure-plan-v2" }, "profile": { "type": "string", "enum": [ "standard", "fast", "single_round", "joint_record", "evaluation", "custom_bounded" ] }, "answerRequired": { "type": "boolean" }, "evidenceRounds": { "type": "integer", "minimum": 1, "maximum": 3 }, "rebuttalRounds": { "type": "integer", "minimum": 0, "maximum": 3 }, "filingsPerSidePerStage": { "type": "integer", "minimum": 1, "maximum": 3 }, "recordConfirmationRequired": { "type": "boolean", "const": true } } }, "CaseDraftParticipantResource": { "type": "object", "additionalProperties": false, "required": [ "participantId", "side", "principalId", "authorizationMode" ], "properties": { "participantId": { "type": "string" }, "side": { "type": "string", "enum": [ "claimant", "respondent" ] }, "partnerId": { "type": "string" }, "principalId": { "type": "string" }, "agentId": { "type": "string" }, "authorizationMode": { "type": "string", "enum": [ "partner_credential", "hosted_account" ] } } }, "CaseDraftConfirmationResource": { "type": "object", "additionalProperties": false, "required": [ "participantId", "side", "authorizationMode", "required", "status", "confirmationStatement" ], "properties": { "participantId": { "type": "string" }, "side": { "type": "string", "enum": [ "claimant", "respondent" ] }, "partnerId": { "type": "string" }, "authorizationMode": { "type": "string", "enum": [ "partner_credential", "hosted_account" ] }, "required": { "type": "boolean" }, "status": { "type": "string", "enum": [ "confirmed", "pending", "not_required" ] }, "confirmationStatement": { "type": "string" } } }, "CaseDraftResource": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "draftId", "reservedCaseId", "externalCaseId", "status", "draftDigest", "expiresAt", "rules", "fee", "caseMode", "intakeMode", "confirmationPolicy", "procedure", "participants", "confirmations" ], "properties": { "schemaVersion": { "type": "string", "const": "case-draft-v2" }, "draftId": { "type": "string" }, "reservedCaseId": { "type": "string" }, "externalCaseId": { "type": "string" }, "status": { "type": "string", "enum": [ "awaiting_confirmations", "ready_to_open", "opened" ] }, "draftDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "expiresAt": { "type": "string", "format": "date-time" }, "rules": { "$ref": "#/components/schemas/CaseDraftRulesStamp" }, "fee": { "type": "object", "description": "Exact-money filing-fee projection in USD minor units.", "additionalProperties": true }, "caseMode": { "type": "string", "enum": [ "proceeding", "evaluation" ] }, "intakeMode": { "type": "string", "enum": [ "claimant_initiated", "claimant_proposed", "bilateral_api", "bundled_bilateral" ] }, "confirmationPolicy": { "type": "object", "additionalProperties": false, "required": [ "mode" ], "properties": { "mode": { "type": "string", "enum": [ "initiator_only", "all_participants", "bundled_authorizations" ] } } }, "procedure": { "$ref": "#/components/schemas/ResolvedCaseProcedure" }, "participants": { "type": "array", "items": { "$ref": "#/components/schemas/CaseDraftParticipantResource" } }, "confirmations": { "type": "array", "items": { "$ref": "#/components/schemas/CaseDraftConfirmationResource" } }, "evaluation": { "$ref": "#/components/schemas/CaseDraftEvaluationDefinition" } } }, "InitialCaseCapabilities": { "type": "object", "additionalProperties": false, "description": "Sensitive capabilities returned only on the initial successful response and never on idempotency replay.", "properties": { "claimantPartyToken": { "type": "string" }, "respondentInviteToken": { "type": "string" }, "respondentLoginPath": { "type": "string", "description": "Tokenized hosted login path for the invited respondent." } } }, "ConfirmedCaseDraft": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "caseId", "externalCaseId", "status", "rules", "createdAt", "headless", "caseMode", "intakeMode", "confirmationPolicy", "procedure", "participants" ], "properties": { "schemaVersion": { "type": "string", "const": "confirmed-filing-v2" }, "caseId": { "type": "string" }, "externalCaseId": { "type": "string" }, "status": { "type": "string" }, "rules": { "$ref": "#/components/schemas/CaseDraftRulesStamp" }, "createdAt": { "type": "string", "format": "date-time" }, "headless": { "type": "object", "additionalProperties": false, "required": [ "respondentHandoffPath", "answerPath", "capabilityDelivery" ], "properties": { "respondentHandoffPath": { "type": "string" }, "answerPath": { "type": "string" }, "hostedRespondentPath": { "type": "string" }, "capabilityDelivery": { "type": "string", "const": "show_once_not_replayed" } } }, "caseMode": { "type": "string", "enum": [ "proceeding", "evaluation" ] }, "intakeMode": { "type": "string", "enum": [ "claimant_initiated", "claimant_proposed", "bilateral_api", "bundled_bilateral" ] }, "confirmationPolicy": { "type": "object", "additionalProperties": false, "required": [ "mode" ], "properties": { "mode": { "type": "string", "enum": [ "initiator_only", "all_participants", "bundled_authorizations" ] } } }, "procedure": { "$ref": "#/components/schemas/ResolvedCaseProcedure" }, "participants": { "type": "array", "items": { "$ref": "#/components/schemas/CaseDraftParticipantResource" } }, "evaluation": { "type": "object", "additionalProperties": false, "required": [ "externalEvaluationId", "evaluationDigest", "resourcePath" ], "properties": { "externalEvaluationId": { "type": "string" }, "evaluationDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "resourcePath": { "type": "string" } } }, "showOnce": { "$ref": "#/components/schemas/InitialCaseCapabilities" } } }, "CaseDraftResourceEnvelope": { "type": "object", "additionalProperties": false, "required": [ "data", "requestId" ], "properties": { "data": { "$ref": "#/components/schemas/CaseDraftResource" }, "requestId": { "type": "string" } } }, "ConfirmedCaseDraftEnvelope": { "type": "object", "additionalProperties": false, "required": [ "data", "requestId" ], "properties": { "data": { "$ref": "#/components/schemas/ConfirmedCaseDraft" }, "requestId": { "type": "string" } } }, "RespondentHandoff": { "type": "object", "additionalProperties": false, "required": [ "schemaVersion", "caseId", "answerPath", "consentMessage", "capabilityDelivery" ], "properties": { "schemaVersion": { "type": "string", "const": "respondent-handoff-v2" }, "caseId": { "type": "string" }, "action": { "type": "string", "enum": [ "file_answer", "accept_evaluation" ] }, "actionPath": { "type": "string" }, "answerPath": { "type": "string", "description": "Alias of actionPath for clients using Answer terminology." }, "hostedRespondentPath": { "type": "string", "description": "Untokenized hosted login path for human respondents. Present for Answer handoffs, not evaluation acceptance." }, "consentMessage": { "type": "string", "description": "Action statement associated with the handoff. For a hosted Answer it is the immutable clickthrough statement bound to the public case and opening draft; for a wallet Answer it is the EIP-191 message whose Case line is the public caseId; for evaluation acceptance it equals confirmationStatement." }, "confirmationStatement": { "type": "string", "description": "Exact digest-bound statement required when accepting a claimant-proposed evaluation." }, "evaluationDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "capabilityDelivery": { "type": "string", "const": "show_once_not_replayed" }, "showOnce": { "type": "object", "additionalProperties": false, "required": [ "respondentInviteToken" ], "properties": { "respondentInviteToken": { "type": "string" }, "respondentLoginPath": { "type": "string", "description": "Show-once tokenized hosted login path. Never returned by an idempotency replay." } } } } }, "Problem": { "type": "object", "required": [ "type", "title", "status", "code", "detail", "requestId" ], "properties": { "type": { "type": "string", "format": "uri" }, "title": { "type": "string" }, "status": { "type": "integer" }, "code": { "type": "string" }, "detail": { "type": "string" }, "requestId": { "type": "string" } } } }, "responses": { "Ap2ResolutionCase": { "description": "Existing Partner API case opened after independent AP2 verification and bilateral resolution authorization.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "requestId" ], "properties": { "data": { "$ref": "#/components/schemas/Ap2ResolutionCaseV1" }, "requestId": { "type": "string" } } } } } }, "UcpResolutionCase": { "description": "Existing Partner API case opened after independent UCP Order verification and bilateral resolution authorization.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "requestId" ], "properties": { "data": { "$ref": "#/components/schemas/UcpResolutionCaseV1" }, "requestId": { "type": "string" } } } } } }, "ResolutionResult": { "description": "Existing Award finality remedy and separate execution projection.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "data", "requestId" ], "properties": { "data": { "$ref": "#/components/schemas/ResolutionResultV1" }, "requestId": { "type": "string" } } } } } }, "Data": { "description": "Versioned data envelope.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "requestId" ], "properties": { "data": {}, "requestId": { "type": "string" } } } } } }, "Problem": { "description": "RFC 9457 style problem response.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }