For the complete documentation index, see llms.txt. This page is also available as Markdown.

POSTpartial

Open the case this account already accepted on People's Court

Use the draft owner’s account access token with filings:write and an idempotency key to open the filing they personally accepted on People’s Court. The current packet must have the owner’s recorded acceptance and meet the fee requirements. This request cannot supply or replace acceptance. While review is incomplete, acceptance_required returns the packet and acceptanceLinkExpiresAt; hostedAcceptanceUrl is included when a replacement link is needed or requested. A payable fee returns filing_fee_required and the draft’s payment link; this operation starts no payment. Accepted unpaid drafts expire after 30 days, returning filing_acceptance_expired. Prepare a fresh packet for acceptance under the current Rules and quote. Already admitted payments can complete or reconcile, and a fresh packet for the same claim uses the existing case and fee. Authorized retries recover the result without opening a second case, including after token refresh or with a new idempotency key.

/api/filings/{id}/confirmationsconfirmAccountFiling

Authentication and authority

Use one listed account-session, scoped OAuth, or partner credential alternative. Account tokens retain the approving account’s authority. Cookie-authenticated writes require same-origin authorization. Alternatives are OR; schemes in one alternative are AND.

AccountOAuth

Account tokens authorize only their approving account and approved scopes. S256 PKCE is mandatory on the code flow. Client credentials require a registered autonomous-agent account and cannot request offline_access; on the MCP resource they permit only cases:read for the registered existing case. Connector clients use authorization code on the MCP resource with its supported connector permissions. Explicit reacceptance is required after Rules or disclosure changes.

Parameters

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

Request body

Optional request body.

application/json

{
  "type": "object",
  "additionalProperties": false,
  "description": "The confirmation carries no acceptance argument. No terms digest, acceptance statement, confirmation reference or principal is accepted; the acceptance is the one already recorded on People's Court.",
  "properties": {
    "rotateAcceptanceLink": {
      "type": "boolean",
      "description": "Replace the one-use hosted acceptance link on an acceptance_required refusal. Ask for this only when the person reports a lost link; the previous link stops working."
    }
  }
}

Responses

201

The case opened from this accepted packet, or the same case on a replay.

application/json

{
  "type": "object",
  "required": [
    "data",
    "requestId"
  ],
  "properties": {
    "data": {
      "$ref": "#/components/schemas/AccountOpenedCase",
      "type": "object",
      "description": "The case this account-owned packet opened. Show-once party capabilities are never returned to an application.",
      "properties": {
        "schemaVersion": {
          "type": "string",
          "const": "account-filing-v1"
        },
        "filingId": {
          "type": "string"
        },
        "caseId": {
          "type": "string"
        },
        "status": {
          "type": "string"
        },
        "filingFeePending": {
          "type": "boolean"
        },
        "track": {
          "type": "string"
        },
        "noticeQueued": {
          "type": "boolean"
        },
        "noticeAddressMasked": {
          "type": "string"
        },
        "acceptance": {
          "type": "object",
          "required": [
            "method",
            "termsDigest"
          ],
          "properties": {
            "method": {
              "type": "string",
              "const": "hosted_clickwrap"
            },
            "termsDigest": {
              "type": "string"
            },
            "attestationHash": {
              "type": "string"
            }
          }
        },
        "links": {
          "type": "object",
          "required": [
            "casePage"
          ],
          "properties": {
            "casePage": {
              "type": "string"
            }
          }
        },
        "idempotencyReplayed": {
          "type": "boolean"
        }
      },
      "required": [
        "schemaVersion",
        "filingId",
        "caseId",
        "status",
        "filingFeePending",
        "track",
        "noticeQueued",
        "acceptance",
        "links",
        "idempotencyReplayed"
      ]
    },
    "requestId": {
      "type": "string"
    }
  }
}
409

Filing conflict, including an unaccepted packet or a payable filing fee.

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."
                }
              }
            }
          }
        }
      ]
    },
    {
      "$ref": "#/components/schemas/FilingFeeRequiredProblem",
      "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",
          "required": [
            "details"
          ],
          "properties": {
            "code": {
              "type": "string",
              "const": "filing_fee_required"
            },
            "details": {
              "$ref": "#/components/schemas/FilingFeeRequiredDetails",
              "type": "object",
              "additionalProperties": false,
              "required": [
                "quotedFeeUsd",
                "filingPath"
              ],
              "properties": {
                "quotedFeeUsd": {
                  "type": "number",
                  "description": "Quoted payable filing fee in USD."
                },
                "filingPath": {
                  "type": "string",
                  "const": "/file",
                  "description": "General filing form path. For a prepared account filing, use filingPaymentUrl to pay the exact accepted draft."
                },
                "filingPaymentUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "Absolute People’s Court URL where the signed-in draft owner can pay and file the exact accepted packet. Payment does not record arbitration acceptance; that remains a separate hosted action."
                },
                "acceptanceExpiresAt": {
                  "type": "string",
                  "format": "date-time",
                  "description": "The accepted unpaid draft must enter payment within 30 days of acceptance. After this deadline, filing_acceptance_expired requires a fresh packet with the current Rules and a new fee quote, followed by the person’s hosted acceptance."
                }
              }
            }
          }
        }
      ]
    },
    {
      "$ref": "#/components/schemas/FilingAcceptanceExpiredProblem",
      "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",
          "required": [
            "details"
          ],
          "properties": {
            "code": {
              "type": "string",
              "const": "filing_acceptance_expired"
            },
            "details": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "acceptanceExpiresAt": {
                  "type": "string",
                  "format": "date-time",
                  "description": "Thirty days after the recorded hosted acceptance. Expiry refuses new payment admission, while already admitted payments complete or reconcile against their original evidence."
                },
                "filingPaymentUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "Absolute owner-only recovery page for the expired filing. The person must request a fresh packet through their connector and separately accept its current Rules and fee quote."
                }
              }
            }
          }
        }
      ]
    }
  ]
}
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": "account-filing-v1",
    "filingId": "filingId_test",
    "caseId": "pcase_test_123",
    "status": "status_test",
    "filingFeePending": false,
    "track": "track_test",
    "noticeQueued": false,
    "acceptance": {
      "method": "hosted_clickwrap",
      "termsDigest": "termsDigest_test"
    },
    "links": {
      "casePage": "casePage_test"
    },
    "idempotencyReplayed": false
  },
  "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.