POSTlive

Confirm one participant in a case draft

Records one participant confirmation. The last required confirmation atomically opens the case. Compatibility alias. Replacement: /api/filings/{id}/confirmations. Same confirmations and opening journal; preserve the exact accepted digest. Window: at least 180 days from equivalent canonical general availability and the published migration guide; dates are emitted only when the shared policy start is configured and canonical routes are enabled.

/api/v2/case-drafts/{draftId}/confirmationsconfirmCaseDraftParticipantV2

Authentication and authority

Send one of the allowed bearer credential roles. Alternatives are OR; credentials named within one alternative are AND.

platformOrchestratorBearer

Credential bound to the platform_orchestrator role.

claimantAgentBearer

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

Credential bound to the respondent_agent role. Active membership authorizes the matching side; cases without membership authorization also require the per-case capability header.

Parameters

NameLocationRequirementSchema
draftIdpathRequired{"type":"string"}
Idempotency-KeyheaderRequired{"type":"string","minLength":8,"maxLength":200}

Request body

Required request body.

application/json

{
  "$ref": "#/components/schemas/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"
    },
    "acceptance": {
      "$ref": "#/components/schemas/FilingAcceptanceProof",
      "oneOf": [
        {
          "$ref": "#/components/schemas/WalletFilingAcceptance",
          "type": "object",
          "additionalProperties": false,
          "required": [
            "method",
            "termsDigest",
            "walletAddress",
            "signature"
          ],
          "properties": {
            "method": {
              "type": "string",
              "const": "wallet_signature"
            },
            "termsDigest": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            },
            "walletAddress": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{40}$"
            },
            "signature": {
              "type": "string",
              "pattern": "^0x[0-9a-fA-F]{130}$"
            }
          }
        },
        {
          "$ref": "#/components/schemas/StandingFilingAcceptance",
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "const": "standing_grant"
            },
            "grantId": {
              "type": "string"
            },
            "termsDigest": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            }
          },
          "required": [
            "method",
            "grantId",
            "termsDigest"
          ],
          "additionalProperties": false
        }
      ]
    }
  }
}

Responses

201

The case opened. Initial capabilities are returned once and are omitted from idempotency replays.

application/json

{
  "$ref": "#/components/schemas/ConfirmedCaseDraftEnvelope",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "data",
    "requestId"
  ],
  "properties": {
    "data": {
      "$ref": "#/components/schemas/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",
          "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"
        },
        "feeCoverage": {
          "$ref": "#/components/schemas/SponsorshipFeeCoverage",
          "type": "object",
          "additionalProperties": false,
          "required": [
            "referralAuthorizationId",
            "status",
            "sponsorDisplayName",
            "feeAmount",
            "partyAmountDue",
            "agreementVersion",
            "agreementHash",
            "billableEvent"
          ],
          "properties": {
            "referralAuthorizationId": {
              "type": "string"
            },
            "status": {
              "type": "string",
              "enum": [
                "covered",
                "settled"
              ]
            },
            "sponsorDisplayName": {
              "type": "string"
            },
            "feeAmount": {
              "$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})$"
                }
              }
            },
            "partyAmountDue": {
              "$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})$"
                }
              }
            },
            "agreementVersion": {
              "type": "integer",
              "minimum": 1
            },
            "agreementHash": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            },
            "billableEvent": {
              "type": "string",
              "const": "case_docketed"
            }
          }
        },
        "feeDisposition": {
          "$ref": "#/components/schemas/PartnerFeeDisposition",
          "type": "object",
          "additionalProperties": false,
          "required": [
            "feeReferralAuthorizationId",
            "assessedFee",
            "partyAmountDue",
            "collectionDisposition",
            "label",
            "agreementVersion",
            "agreementHash"
          ],
          "properties": {
            "feeReferralAuthorizationId": {
              "type": "string"
            },
            "assessedFee": {
              "$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})$"
                }
              }
            },
            "partyAmountDue": {
              "$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})$"
                }
              }
            },
            "collectionDisposition": {
              "type": "string",
              "enum": [
                "party_due",
                "party_paid",
                "partner_covered_per_case",
                "partner_covered_by_plan",
                "forum_waived",
                "cancelled"
              ]
            },
            "label": {
              "type": "string"
            },
            "agreementVersion": {
              "type": "integer",
              "minimum": 1
            },
            "agreementHash": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            }
          }
        },
        "feeChallenge": {
          "$ref": "#/components/schemas/PartnerFeeCheckoutChallenge",
          "type": "object",
          "additionalProperties": false,
          "required": [
            "method",
            "amount",
            "caseId",
            "checkoutEndpoint",
            "httpMethod",
            "requestBody",
            "authorization"
          ],
          "properties": {
            "method": {
              "type": "string",
              "const": "fiat_card"
            },
            "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})$"
                }
              }
            },
            "caseId": {
              "type": "string",
              "description": "Public Partner API case ID accepted by checkoutEndpoint."
            },
            "checkoutEndpoint": {
              "type": "string",
              "const": "/api/v2/fees/stripe/checkout"
            },
            "httpMethod": {
              "type": "string",
              "const": "POST"
            },
            "requestBody": {
              "$ref": "#/components/schemas/PartnerFilingCheckoutInput",
              "type": "object",
              "additionalProperties": false,
              "required": [
                "caseId"
              ],
              "properties": {
                "caseId": {
                  "type": "string",
                  "pattern": "^pcase_[A-Za-z0-9_-]{1,96}$",
                  "description": "Public Partner API case ID owned by the authenticated partner."
                }
              }
            },
            "authorization": {
              "type": "string",
              "const": "partner_bearer"
            }
          }
        },
        "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",
          "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
            }
          }
        },
        "participants": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/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"
                ]
              }
            }
          }
        },
        "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",
          "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."
            }
          }
        }
      }
    },
    "requestId": {
      "type": "string"
    }
  }
}
202

The confirmation was recorded, but another required participant confirmation is still pending.

application/json

{
  "$ref": "#/components/schemas/CaseDraftResourceEnvelope",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "data",
    "requestId"
  ],
  "properties": {
    "data": {
      "$ref": "#/components/schemas/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",
          "type": "object",
          "additionalProperties": false,
          "required": [
            "version",
            "hash"
          ],
          "properties": {
            "version": {
              "type": "string"
            },
            "hash": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            }
          }
        },
        "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",
          "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
            }
          }
        },
        "participants": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/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"
                ]
              }
            }
          }
        },
        "confirmations": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/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"
              }
            }
          }
        },
        "evaluation": {
          "$ref": "#/components/schemas/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",
                "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"
                        ]
                      }
                    }
                  }
                }
              }
            },
            "evidencePolicy": {
              "$ref": "#/components/schemas/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
                }
              }
            },
            "reviewPolicy": {
              "$ref": "#/components/schemas/NarrowEvaluationReviewPolicy",
              "type": "object",
              "additionalProperties": false,
              "required": [
                "initialPath",
                "humanReviewRequired"
              ],
              "properties": {
                "initialPath": {
                  "type": "string",
                  "const": "adjudicative"
                },
                "humanReviewRequired": {
                  "type": "boolean",
                  "const": false
                }
              }
            }
          }
        },
        "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"
                  }
                }
              }
            },
            "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"
    }
  }
}
409

Conflict, including acceptance_required. Hosted acceptance, explicit principal-bound API acceptance, or an exact wallet signature is required for new packets. Standing grants require step 11. Authorized claimant callers receive the packet digest and a new scoped hosted link.

application/problem+json

{
  "anyOf": [
    {
      "$ref": "#/components/schemas/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"
        },
        "details": {
          "description": "Account-readiness refusals include a value-free checklist and exact account-page link. Other error codes may provide different details.",
          "anyOf": [
            {
              "$ref": "#/components/schemas/AccountReadinessDetails",
              "type": "object",
              "additionalProperties": false,
              "required": [
                "ready",
                "accountSetupUrl",
                "missing"
              ],
              "properties": {
                "ready": {
                  "type": "boolean"
                },
                "accountSetupUrl": {
                  "type": "string",
                  "format": "uri"
                },
                "missing": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AccountReadinessRequirement",
                    "type": "object",
                    "additionalProperties": false,
                    "required": [
                      "code",
                      "label",
                      "section",
                      "accountUrl"
                    ],
                    "properties": {
                      "code": {
                        "type": "string"
                      },
                      "label": {
                        "type": "string"
                      },
                      "section": {
                        "type": "string",
                        "enum": [
                          "email",
                          "identity",
                          "legal_documents"
                        ]
                      },
                      "accountUrl": {
                        "type": "string",
                        "format": "uri"
                      }
                    }
                  }
                }
              }
            },
            {
              "$ref": "#/components/schemas/LegalDocumentsRequiredDetails",
              "type": "object",
              "additionalProperties": false,
              "required": [
                "legalDocumentsUrl"
              ],
              "properties": {
                "legalDocumentsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "Absolute account-page URL where the person reviews and accepts the current Terms and Privacy Notice. Uses the configured public application origin. After accepting the documents, retry the original operation."
                },
                "ready": {
                  "type": "boolean"
                },
                "accountSetupUrl": {
                  "type": "string",
                  "format": "uri"
                },
                "missing": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AccountReadinessRequirement",
                    "type": "object",
                    "additionalProperties": false,
                    "required": [
                      "code",
                      "label",
                      "section",
                      "accountUrl"
                    ],
                    "properties": {
                      "code": {
                        "type": "string"
                      },
                      "label": {
                        "type": "string"
                      },
                      "section": {
                        "type": "string",
                        "enum": [
                          "email",
                          "identity",
                          "legal_documents"
                        ]
                      },
                      "accountUrl": {
                        "type": "string",
                        "format": "uri"
                      }
                    }
                  }
                }
              }
            },
            {}
          ]
        }
      }
    },
    {
      "$ref": "#/components/schemas/FilingAcceptanceRequiredProblem",
      "allOf": [
        {
          "$ref": "#/components/schemas/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"
            },
            "details": {
              "description": "Account-readiness refusals include a value-free checklist and exact account-page link. Other error codes may provide different details.",
              "anyOf": [
                {
                  "$ref": "#/components/schemas/AccountReadinessDetails",
                  "type": "object",
                  "additionalProperties": false,
                  "required": [
                    "ready",
                    "accountSetupUrl",
                    "missing"
                  ],
                  "properties": {
                    "ready": {
                      "type": "boolean"
                    },
                    "accountSetupUrl": {
                      "type": "string",
                      "format": "uri"
                    },
                    "missing": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/AccountReadinessRequirement"
                      }
                    }
                  }
                },
                {
                  "$ref": "#/components/schemas/LegalDocumentsRequiredDetails",
                  "type": "object",
                  "additionalProperties": false,
                  "required": [
                    "legalDocumentsUrl"
                  ],
                  "properties": {
                    "legalDocumentsUrl": {
                      "type": "string",
                      "format": "uri",
                      "description": "Absolute account-page URL where the person reviews and accepts the current Terms and Privacy Notice. Uses the configured public application origin. After accepting the documents, retry the original operation."
                    },
                    "ready": {
                      "type": "boolean"
                    },
                    "accountSetupUrl": {
                      "type": "string",
                      "format": "uri"
                    },
                    "missing": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/AccountReadinessRequirement"
                      }
                    }
                  }
                },
                {}
              ]
            }
          }
        },
        {
          "type": "object",
          "properties": {
            "code": {
              "type": "string",
              "const": "acceptance_required"
            },
            "details": {
              "$ref": "#/components/schemas/FilingAcceptanceRequiredDetails",
              "type": "object",
              "additionalProperties": false,
              "required": [
                "termsDigest"
              ],
              "properties": {
                "termsDigest": {
                  "type": "string",
                  "pattern": "^[a-f0-9]{64}$"
                },
                "reviewPacket": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/FilingReviewPacket"
                    },
                    {
                      "$ref": "#/components/schemas/AccountFilingReviewPacket"
                    }
                  ]
                },
                "hostedAcceptanceUrl": {
                  "type": "string"
                },
                "acceptanceLinkExpiresAt": {
                  "type": "string",
                  "format": "date-time",
                  "description": "Expiry of the account filing’s current hosted acceptance link."
                }
              }
            }
          }
        }
      ]
    }
  ]
}
default

RFC 9457 style problem response.

application/problem+json

{
  "$ref": "#/components/schemas/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"
    },
    "details": {
      "description": "Account-readiness refusals include a value-free checklist and exact account-page link. Other error codes may provide different details.",
      "anyOf": [
        {
          "$ref": "#/components/schemas/AccountReadinessDetails",
          "type": "object",
          "additionalProperties": false,
          "required": [
            "ready",
            "accountSetupUrl",
            "missing"
          ],
          "properties": {
            "ready": {
              "type": "boolean"
            },
            "accountSetupUrl": {
              "type": "string",
              "format": "uri"
            },
            "missing": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/AccountReadinessRequirement",
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "code",
                  "label",
                  "section",
                  "accountUrl"
                ],
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "label": {
                    "type": "string"
                  },
                  "section": {
                    "type": "string",
                    "enum": [
                      "email",
                      "identity",
                      "legal_documents"
                    ]
                  },
                  "accountUrl": {
                    "type": "string",
                    "format": "uri"
                  }
                }
              }
            }
          }
        },
        {
          "$ref": "#/components/schemas/LegalDocumentsRequiredDetails",
          "type": "object",
          "additionalProperties": false,
          "required": [
            "legalDocumentsUrl"
          ],
          "properties": {
            "legalDocumentsUrl": {
              "type": "string",
              "format": "uri",
              "description": "Absolute account-page URL where the person reviews and accepts the current Terms and Privacy Notice. Uses the configured public application origin. After accepting the documents, retry the original operation."
            },
            "ready": {
              "type": "boolean"
            },
            "accountSetupUrl": {
              "type": "string",
              "format": "uri"
            },
            "missing": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/AccountReadinessRequirement",
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "code",
                  "label",
                  "section",
                  "accountUrl"
                ],
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "label": {
                    "type": "string"
                  },
                  "section": {
                    "type": "string",
                    "enum": [
                      "email",
                      "identity",
                      "legal_documents"
                    ]
                  },
                  "accountUrl": {
                    "type": "string",
                    "format": "uri"
                  }
                }
              }
            }
          }
        },
        {}
      ]
    }
  }
}

Example response

Successful response

{
  "data": {
    "schemaVersion": "confirmed-filing-v2",
    "caseId": "pcase_test_123",
    "externalCaseId": "marketplace_case_123",
    "status": "status_test",
    "rules": {
      "version": "version_test",
      "hash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "createdAt": "2026-08-09T12:00:00.000Z",
    "headless": {
      "respondentHandoffPath": "respondentHandoffPath_test",
      "answerPath": "answerPath_test",
      "capabilityDelivery": "show_once_not_replayed"
    },
    "caseMode": "proceeding",
    "intakeMode": "claimant_initiated",
    "confirmationPolicy": {
      "mode": "initiator_only"
    },
    "procedure": {
      "schemaVersion": "case-procedure-plan-v2",
      "profile": "standard",
      "answerRequired": false,
      "evidenceRounds": 1,
      "rebuttalRounds": 1,
      "filingsPerSidePerStage": 1,
      "recordConfirmationRequired": true
    },
    "participants": [
      {
        "participantId": "participant_test_123",
        "side": "claimant",
        "principalId": "principal_test_123",
        "authorizationMode": "partner_credential"
      }
    ]
  },
  "requestId": "requestId_test"
}

Errors

Read the response status and stable error code. See errors and rate limits for recovery. Refresh the resource before resolving a state or digest conflict.

Idempotency and retries

  • For throttling, honor Retry-After when present. Back off on retryable server failures.
  • Send a unique Idempotency-Key. An exact retry returns the stored result; reusing the key with a different request fails.
  • The request is accepted only when its credential, authority, case state, and resource preconditions are satisfied.

Likely next action: Read the opened case or remaining confirmations →