200
Canonical filing preparation state
application/json
{
"type": "object",
"required": [
"data",
"requestId"
],
"properties": {
"data": {
"$ref": "#/components/schemas/CanonicalPreparedFiling",
"type": "object",
"additionalProperties": true,
"required": [
"schemaVersion",
"draftId",
"draftDigest",
"procedure",
"schedule",
"parties",
"caseTrack",
"appealWaived",
"procedureTerms"
],
"properties": {
"schemaVersion": {
"type": "string",
"const": "filing-v1"
},
"draftId": {
"type": "string"
},
"draftDigest": {
"type": "string"
},
"procedure": {
"type": "string",
"enum": [
"ai_fast",
"ai_standard",
"ai_assisted_human"
]
},
"schedule": {
"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
},
"schemaVersion": {
"type": "string",
"const": "case-procedure-plan-v2"
}
}
},
"parties": {
"type": "object",
"additionalProperties": false,
"required": [
"claimant",
"respondent"
],
"properties": {
"claimant": {
"type": "object",
"additionalProperties": false,
"required": [
"externalId",
"name",
"principalKind"
],
"properties": {
"externalId": {
"type": "string"
},
"name": {
"type": "string"
},
"principalKind": {
"$ref": "#/components/schemas/CanonicalPrincipalKind",
"type": "string",
"enum": [
"individual",
"organization",
"autonomous_agent"
]
}
}
},
"respondent": {
"type": "object",
"additionalProperties": false,
"required": [
"externalId",
"name",
"principalKind"
],
"properties": {
"externalId": {
"type": "string"
},
"name": {
"type": "string"
},
"principalKind": {
"$ref": "#/components/schemas/CanonicalPrincipalKind",
"type": "string",
"enum": [
"individual",
"organization",
"autonomous_agent"
]
}
}
}
}
},
"status": {
"type": "string",
"description": "Current filing preparation state. awaiting_agent_acceptances applies only to existing drafts already bound to the Agent-only procedure."
},
"agentConsentUrl": {
"type": "string",
"description": "Only for an existing draft already bound to the Agent-only procedure: each bound account uses its own OAuth token to read and accept its exact statement. Not issued for new preparations."
},
"hostedAcceptanceUrl": {
"type": "string",
"description": "Standard procedure: show-once claimant acceptance link, omitted on replay."
},
"reviewPacket": {
"$ref": "#/components/schemas/FilingReviewPacket",
"type": "object",
"additionalProperties": false,
"required": [
"schemaVersion",
"draftId",
"caseId",
"draftDigest",
"parties",
"claimantIdentity",
"agentOfRecord",
"preparingPartnerId",
"claimSummary",
"claimStatement",
"requestedItems",
"amount",
"rules",
"procedure",
"aiDisclosure",
"fees",
"requiredConfirmations",
"scope",
"expiresAt",
"termsDigest",
"acceptanceStatement",
"walletMessage",
"procedureTerms"
],
"properties": {
"schemaVersion": {
"type": "string",
"const": "filing-review-packet-v1"
},
"draftId": {
"type": "string"
},
"caseId": {
"type": "string"
},
"draftDigest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"parties": {
"type": "object",
"additionalProperties": false,
"required": [
"claimant",
"respondent"
],
"properties": {
"claimant": {
"type": "object",
"additionalProperties": false,
"required": [
"principalId",
"name"
],
"properties": {
"principalId": {
"type": "string"
},
"name": {
"type": "string"
}
}
},
"respondent": {
"type": "object",
"additionalProperties": false,
"required": [
"principalId",
"name"
],
"properties": {
"principalId": {
"type": "string"
},
"name": {
"type": "string"
}
}
}
}
},
"claimantIdentity": {
"$ref": "#/components/schemas/ClaimantAcceptanceIdentity",
"type": "object",
"additionalProperties": false,
"required": [
"email"
],
"properties": {
"accountId": {
"type": "string",
"description": "Optional People’s Court account ID allowed to accept. Otherwise the signed-in account must have the normalized, verified claimant email."
},
"email": {
"type": "string",
"format": "email",
"description": "Requires a signed-in account with this verified email."
},
"walletAddress": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
}
}
},
"agentOfRecord": {
"type": "string"
},
"preparingPartnerId": {
"type": "string"
},
"claimSummary": {
"type": "string"
},
"claimStatement": {
"type": "string"
},
"requestedItems": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"id",
"kind",
"text"
],
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"refund",
"release",
"split",
"other",
"monetary",
"declaratory",
"order"
]
},
"text": {
"type": "string"
},
"amount": {
"$ref": "#/components/schemas/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})$"
}
}
}
}
}
},
"amount": {
"$ref": "#/components/schemas/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})$"
}
}
},
"rules": {
"type": "object",
"additionalProperties": false,
"required": [
"version",
"hash"
],
"properties": {
"version": {
"type": "string"
},
"hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
}
},
"procedure": {
"type": "object",
"additionalProperties": false,
"required": [
"name",
"finalityPath",
"configuration"
],
"properties": {
"name": {
"type": "string",
"enum": [
"ai_fast",
"ai_standard",
"ai_assisted_human"
]
},
"finalityPath": {
"type": "string",
"enum": [
"human_appeal",
"appeal_waived"
]
},
"configuration": {
"type": "object",
"additionalProperties": true
},
"agentFinalityTerms": {
"type": "object",
"additionalProperties": {
"type": "string"
},
"description": "Exact registered Rules, behavior and disclosure tuple, including its termsHash."
}
}
},
"aiDisclosure": {
"type": "object",
"additionalProperties": false,
"required": [
"version",
"hash"
],
"properties": {
"version": {
"type": "string"
},
"hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
}
},
"fees": {
"type": "object",
"additionalProperties": true
},
"requiredConfirmations": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"side",
"principalId",
"required",
"statement"
],
"properties": {
"side": {
"type": "string",
"enum": [
"claimant",
"respondent"
]
},
"principalId": {
"type": "string"
},
"required": {
"type": "boolean"
},
"statement": {
"type": "string"
}
}
}
},
"scope": {
"type": "string"
},
"expiresAt": {
"type": "string",
"format": "date-time"
},
"termsDigest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"acceptanceStatement": {
"type": "string"
},
"walletMessage": {
"type": "string"
},
"procedureTerms": {
"$ref": "#/components/schemas/CaseProcedureTerms",
"type": "object",
"additionalProperties": false,
"required": [
"schemaVersion",
"track",
"appealWaived",
"waiverDisclosureVersion",
"waiverDisclosureHash",
"rulesVersion",
"rulesHash",
"behaviorVersion",
"disclosureVersion",
"disclosureHash",
"feePolicyVersion",
"termsHash"
],
"properties": {
"schemaVersion": {
"type": "string",
"const": "case-procedure-v1"
},
"track": {
"type": "string",
"enum": [
"ai_fast",
"ai_standard",
"ai_assisted_human"
]
},
"appealWaived": {
"type": "boolean"
},
"waiverDisclosureVersion": {
"type": "string",
"minLength": 1
},
"waiverDisclosureHash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"rulesVersion": {
"type": "string",
"minLength": 1
},
"rulesHash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"behaviorVersion": {
"type": "string",
"minLength": 1
},
"disclosureVersion": {
"type": "string",
"minLength": 1
},
"disclosureHash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"feePolicyVersion": {
"type": "string",
"minLength": 1
},
"termsHash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
}
}
}
},
"caseTrack": {
"type": "string",
"enum": [
"ai_fast",
"ai_standard",
"ai_assisted_human"
]
},
"appealWaived": {
"type": "boolean"
},
"procedureTerms": {
"$ref": "#/components/schemas/CaseProcedureTerms",
"type": "object",
"additionalProperties": false,
"required": [
"schemaVersion",
"track",
"appealWaived",
"waiverDisclosureVersion",
"waiverDisclosureHash",
"rulesVersion",
"rulesHash",
"behaviorVersion",
"disclosureVersion",
"disclosureHash",
"feePolicyVersion",
"termsHash"
],
"properties": {
"schemaVersion": {
"type": "string",
"const": "case-procedure-v1"
},
"track": {
"type": "string",
"enum": [
"ai_fast",
"ai_standard",
"ai_assisted_human"
]
},
"appealWaived": {
"type": "boolean"
},
"waiverDisclosureVersion": {
"type": "string",
"minLength": 1
},
"waiverDisclosureHash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"rulesVersion": {
"type": "string",
"minLength": 1
},
"rulesHash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"behaviorVersion": {
"type": "string",
"minLength": 1
},
"disclosureVersion": {
"type": "string",
"minLength": 1
},
"disclosureHash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"feePolicyVersion": {
"type": "string",
"minLength": 1
},
"termsHash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
}
}
}
},
"requestId": {
"type": "string"
}
}
}