Required request body.
application/json
{
"$ref": "#/components/schemas/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",
"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"
}
}
}
}
},
"resolutionHandoff": {
"$ref": "#/components/schemas/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",
"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]*)$"
}
}
},
"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",
"type": "object",
"additionalProperties": false,
"required": [
"version",
"digest"
],
"properties": {
"version": {
"type": "string"
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
}
},
"terms": {
"$ref": "#/components/schemas/ResolutionDigestVersionV1",
"type": "object",
"additionalProperties": false,
"required": [
"version",
"digest"
],
"properties": {
"version": {
"type": "string"
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
}
},
"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",
"type": "object",
"additionalProperties": false,
"required": [
"schemaVersion",
"transactionId",
"orderId",
"disputedLineItemIds",
"policyDigest",
"termsDigest",
"authorityRefs",
"includedArtifacts",
"excludedArtifacts"
],
"properties": {}
},
"digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
}
},
"remedyCeilings": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/components/schemas/ResolutionHandoffRemedyV1",
"type": "object",
"additionalProperties": false,
"required": [
"action",
"currency",
"amountMinorUnits"
],
"properties": {
"action": {},
"currency": {},
"amountMinorUnits": {}
}
}
},
"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
}
}
}
}
},
"resolutionAuthorization": {
"$ref": "#/components/schemas/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": {},
"required": [
"side"
]
},
"minContains": 1,
"maxContains": 1
},
{
"contains": {
"type": "object",
"properties": {},
"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": {}
},
"agentAuthority": {
"type": "object",
"additionalProperties": false,
"required": [
"agentId",
"representedPrincipalId",
"allowedActs",
"maximumAmount",
"expiresAt",
"delegationArtifactRef",
"delegationArtifactHash"
],
"properties": {}
}
}
}
},
"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",
"type": "object",
"additionalProperties": false,
"required": [
"scope",
"claimTypes",
"maximumAmount"
],
"properties": {
"scope": {
"type": "string"
},
"claimTypes": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {}
},
"maximumAmount": {
"$ref": "#/components/schemas/ResolutionMoneyV1"
}
}
},
"appointment": {
"$ref": "#/components/schemas/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"
}
}
},
"rules": {
"$ref": "#/components/schemas/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://"
}
}
},
"terms": {
"$ref": "#/components/schemas/ResolutionTermsV1",
"type": "object",
"additionalProperties": false,
"required": [
"version",
"hash"
],
"properties": {
"version": {
"type": "string"
},
"hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
}
},
"legalContext": {
"$ref": "#/components/schemas/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
}
}
},
"availableRemedies": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/components/schemas/ResolutionRemedyV1",
"type": "object",
"additionalProperties": false,
"required": [
"code",
"settlementAction",
"maximumAmount"
],
"properties": {
"code": {},
"settlementAction": {},
"maximumAmount": {
"$ref": "#/components/schemas/ResolutionMoneyV1"
}
}
}
},
"executionProvider": {
"$ref": "#/components/schemas/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": {}
},
"authorizationExpiresAt": {
"type": "string",
"format": "date-time"
}
}
},
"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": {}
}
}
}
}
}
},
"proposedCase": {
"$ref": "#/components/schemas/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",
"type": "object",
"additionalProperties": false,
"required": [
"scope",
"claimTypes",
"maximumAmount"
],
"properties": {
"scope": {
"type": "string"
},
"claimTypes": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {}
},
"maximumAmount": {
"$ref": "#/components/schemas/ResolutionMoneyV1"
}
}
},
"appointment": {
"$ref": "#/components/schemas/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"
}
}
},
"rules": {
"$ref": "#/components/schemas/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://"
}
}
},
"terms": {
"$ref": "#/components/schemas/ResolutionTermsV1",
"type": "object",
"additionalProperties": false,
"required": [
"version",
"hash"
],
"properties": {
"version": {
"type": "string"
},
"hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
}
},
"legalContext": {
"$ref": "#/components/schemas/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
}
}
},
"availableRemedies": {
"type": "array",
"minItems": 1,
"items": {
"$ref": "#/components/schemas/ResolutionRemedyV1",
"type": "object",
"additionalProperties": false,
"required": [
"code",
"settlementAction",
"maximumAmount"
],
"properties": {
"code": {},
"settlementAction": {},
"maximumAmount": {
"$ref": "#/components/schemas/ResolutionMoneyV1"
}
}
}
},
"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",
"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": {}
},
"authorizationExpiresAt": {
"type": "string",
"format": "date-time"
}
}
}
}
}
}
}