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

GETpartial

Read your own account-owned filing packet

Account branch, selected by a People's Court account access token with filings:write — the same authority that prepared the draft. Ownership is enforced before anything is read, and a draft owned by another account is not found. A prepared packet is rebuilt from the draft's own fields, so a moved Rules version, disclosure or published price refuses with filing_packet_changed rather than serving a stale packet; a confirmed draft keeps the packet its case was opened on and names that case. The one-use hosted acceptance link is a capability and is never re-served here: it is returned once by preparation, and a lost link is replaced by confirming with rotateAcceptanceLink.

/api/filings/{id}getAccountFiling

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"}

Responses

200

The account-owned filing draft and its review packet, without any acceptance link.

application/json

{
  "type": "object",
  "required": [
    "data",
    "requestId"
  ],
  "properties": {
    "data": {
      "$ref": "#/components/schemas/AccountPreparedFiling",
      "type": "object",
      "description": "An immutable account-owned filing draft and its review packet.",
      "properties": {
        "schemaVersion": {
          "type": "string",
          "const": "account-filing-v1"
        },
        "filingId": {
          "type": "string"
        },
        "procedure": {
          "type": "string",
          "enum": [
            "ai_fast",
            "ai_standard",
            "ai_assisted_human"
          ]
        },
        "schedule": {
          "type": "object",
          "required": [
            "profile"
          ],
          "properties": {
            "profile": {
              "type": "string",
              "const": "standard"
            }
          }
        },
        "status": {
          "type": "string",
          "enum": [
            "awaiting_acceptance",
            "accepted"
          ]
        },
        "owner": {
          "type": "object",
          "required": [
            "accountId"
          ],
          "properties": {
            "accountId": {
              "type": "string"
            }
          }
        },
        "draftDigest": {
          "type": "string"
        },
        "termsDigest": {
          "type": "string"
        },
        "expiresAt": {
          "type": "string"
        },
        "acceptance": {
          "type": "object",
          "required": [
            "required",
            "method",
            "recorded"
          ],
          "properties": {
            "required": {
              "type": "boolean",
              "const": true
            },
            "method": {
              "type": "string",
              "const": "hosted_clickwrap"
            },
            "recorded": {
              "type": "boolean"
            },
            "acceptedAt": {
              "type": "string"
            }
          }
        },
        "reviewPacket": {
          "$ref": "#/components/schemas/AccountFilingReviewPacket",
          "type": "object",
          "description": "The exact packet the person reviews and accepts on People's Court. It contains only prepared typed filing fields; no capability, token or private preparation note enters it.",
          "properties": {
            "schemaVersion": {
              "type": "string",
              "const": "account-filing-review-packet-v1"
            },
            "draftId": {
              "type": "string"
            },
            "caseId": {
              "type": "string",
              "description": "Case identity reserved for this packet."
            },
            "draftDigest": {
              "type": "string"
            },
            "termsDigest": {
              "type": "string"
            },
            "acceptanceStatement": {
              "type": "string"
            },
            "parties": {
              "type": "object",
              "required": [
                "claimant",
                "respondent"
              ],
              "properties": {
                "claimant": {
                  "type": "object",
                  "required": [
                    "principalId",
                    "name",
                    "principalKind"
                  ],
                  "properties": {
                    "principalId": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "principalKind": {
                      "$ref": "#/components/schemas/CanonicalPrincipalKind"
                    }
                  }
                },
                "respondent": {
                  "type": "object",
                  "required": [
                    "name",
                    "principalKind"
                  ],
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "principalKind": {
                      "$ref": "#/components/schemas/CanonicalPrincipalKind"
                    },
                    "noticeAddress": {
                      "type": "object",
                      "required": [
                        "email",
                        "source"
                      ],
                      "properties": {
                        "email": {
                          "type": "string"
                        },
                        "source": {
                          "type": "string",
                          "enum": [
                            "claimant_attested",
                            "agreement",
                            "notice_designation"
                          ]
                        }
                      }
                    }
                  }
                }
              }
            },
            "claimantIdentity": {
              "type": "object",
              "required": [
                "accountId",
                "email"
              ],
              "properties": {
                "accountId": {
                  "type": "string"
                },
                "email": {
                  "type": "string"
                }
              }
            },
            "agentOfRecord": {
              "type": "string"
            },
            "claimSummary": {
              "type": "string"
            },
            "claimStatement": {
              "type": "string"
            },
            "requestedItems": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "id",
                  "kind",
                  "text"
                ],
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "kind": {
                    "type": "string",
                    "enum": [
                      "monetary",
                      "declaratory",
                      "order"
                    ]
                  },
                  "text": {
                    "type": "string"
                  },
                  "amount": {
                    "$ref": "#/components/schemas/FiatMoney",
                    "type": "object",
                    "additionalProperties": false,
                    "required": [
                      "currency",
                      "minorUnits"
                    ],
                    "properties": {
                      "currency": {
                        "type": "string",
                        "const": "USD"
                      },
                      "minorUnits": {
                        "type": "string",
                        "pattern": "^(0|[1-9][0-9]{0,77})$"
                      }
                    }
                  }
                }
              }
            },
            "amount": {
              "$ref": "#/components/schemas/FiatMoney",
              "type": "object",
              "additionalProperties": false,
              "required": [
                "currency",
                "minorUnits"
              ],
              "properties": {
                "currency": {
                  "type": "string",
                  "const": "USD"
                },
                "minorUnits": {
                  "type": "string",
                  "pattern": "^(0|[1-9][0-9]{0,77})$"
                }
              }
            },
            "governingLaw": {
              "type": "string"
            },
            "rules": {
              "type": "object",
              "required": [
                "version",
                "hash"
              ],
              "properties": {
                "version": {
                  "type": "string"
                },
                "hash": {
                  "type": "string"
                }
              }
            },
            "procedure": {
              "type": "object",
              "required": [
                "name",
                "finalityPath",
                "schedule"
              ],
              "properties": {
                "name": {
                  "type": "string",
                  "enum": [
                    "ai_fast",
                    "ai_standard",
                    "ai_assisted_human"
                  ]
                },
                "finalityPath": {
                  "type": "string",
                  "enum": [
                    "human_appeal",
                    "appeal_waived"
                  ]
                },
                "schedule": {
                  "type": "object",
                  "required": [
                    "profile"
                  ],
                  "properties": {
                    "profile": {
                      "type": "string",
                      "const": "standard"
                    }
                  }
                }
              }
            },
            "aiDisclosure": {
              "type": "object",
              "required": [
                "version",
                "hash"
              ],
              "properties": {
                "version": {
                  "type": "string"
                },
                "hash": {
                  "type": "string"
                }
              }
            },
            "fees": {
              "type": "object",
              "description": "Quoted filing fee in exact USD at the published schedule's precision, its collection mode, and the stated prerequisite for opening under this packet. A payable fee is completed on People's Court; this branch initiates no payment.",
              "properties": {
                "collection": {
                  "type": "string",
                  "enum": [
                    "off",
                    "waived",
                    "collect"
                  ]
                },
                "payable": {
                  "type": "boolean"
                },
                "quotedUsd": {
                  "type": "string"
                },
                "tier": {
                  "type": "string"
                },
                "prerequisite": {
                  "type": "string",
                  "enum": [
                    "none",
                    "filing_fee_paid_on_peoples_court"
                  ]
                }
              },
              "required": [
                "collection",
                "payable",
                "quotedUsd",
                "tier",
                "prerequisite"
              ]
            },
            "respondentConsent": {
              "type": "object",
              "required": [
                "mode",
                "statement"
              ],
              "properties": {
                "mode": {
                  "type": "string",
                  "const": "deferred_hosted_account"
                },
                "statement": {
                  "type": "string"
                }
              }
            },
            "requiredConfirmations": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "side",
                  "principalId",
                  "required",
                  "statement"
                ],
                "properties": {
                  "side": {
                    "type": "string",
                    "const": "claimant"
                  },
                  "principalId": {
                    "type": "string"
                  },
                  "required": {
                    "type": "boolean",
                    "const": true
                  },
                  "statement": {
                    "type": "string"
                  }
                }
              }
            },
            "declaration": {
              "type": "object",
              "required": [
                "declarantName",
                "declarantCapacity",
                "executionLocation"
              ],
              "properties": {
                "declarantName": {
                  "type": "string"
                },
                "declarantCapacity": {
                  "type": "string"
                },
                "executionLocation": {
                  "type": "string"
                }
              }
            },
            "scope": {
              "type": "string"
            },
            "expiresAt": {
              "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}$"
                }
              }
            }
          },
          "required": [
            "schemaVersion",
            "draftId",
            "caseId",
            "draftDigest",
            "termsDigest",
            "acceptanceStatement",
            "parties",
            "claimantIdentity",
            "claimSummary",
            "claimStatement",
            "requestedItems",
            "amount",
            "governingLaw",
            "rules",
            "procedure",
            "aiDisclosure",
            "fees",
            "respondentConsent",
            "requiredConfirmations",
            "declaration",
            "scope",
            "expiresAt",
            "procedureTerms"
          ]
        },
        "hostedAcceptanceUrl": {
          "type": "string",
          "description": "One-use hosted acceptance link returned once at preparation. Replays and draft GET omit it. Replacement requires explicit rotateAcceptanceLink outside the connector."
        },
        "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}$"
            }
          }
        }
      },
      "required": [
        "schemaVersion",
        "filingId",
        "procedure",
        "schedule",
        "status",
        "owner",
        "draftDigest",
        "termsDigest",
        "expiresAt",
        "acceptance",
        "reviewPacket",
        "caseTrack",
        "appealWaived",
        "procedureTerms"
      ]
    },
    "requestId": {
      "type": "string"
    }
  }
}
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",
    "procedure": "ai_fast",
    "schedule": {
      "profile": "standard"
    },
    "status": "awaiting_acceptance",
    "owner": {
      "accountId": "accountId_test"
    },
    "draftDigest": "draftDigest_test",
    "termsDigest": "termsDigest_test",
    "expiresAt": "expiresAt_test",
    "acceptance": {
      "required": true,
      "method": "hosted_clickwrap",
      "recorded": false
    },
    "reviewPacket": {
      "schemaVersion": "account-filing-review-packet-v1",
      "draftId": "draft_test_123",
      "caseId": "pcase_test_123",
      "draftDigest": "draftDigest_test",
      "termsDigest": "termsDigest_test",
      "acceptanceStatement": "The test delivery did not match the agreed specification.",
      "parties": {
        "claimant": {
          "principalId": "principal_test_123",
          "name": "Maya Chen",
          "principalKind": "individual"
        },
        "respondent": {
          "name": "Northwind Goods",
          "principalKind": "individual"
        }
      },
      "claimantIdentity": {
        "accountId": "accountId_test",
        "email": "maya.chen@example.com"
      },
      "claimSummary": "Test-environment contract delivery dispute.",
      "claimStatement": "The test delivery did not match the agreed specification.",
      "requestedItems": [
        {
          "id": "id_test",
          "kind": "monetary",
          "text": "Test-environment procedural message."
        }
      ],
      "amount": {
        "currency": "USD",
        "minorUnits": "12500"
      },
      "governingLaw": "governingLaw_test",
      "rules": {
        "version": "version_test",
        "hash": "hash_test"
      },
      "procedure": {
        "name": "ai_fast",
        "finalityPath": "human_appeal",
        "schedule": {
          "profile": "standard"
        }
      },
      "aiDisclosure": {
        "version": "version_test",
        "hash": "hash_test"
      },
      "fees": {
        "collection": "off",
        "payable": false,
        "quotedUsd": "quotedUsd_test",
        "tier": "tier_test",
        "prerequisite": "none"
      },
      "respondentConsent": {
        "mode": "deferred_hosted_account",
        "statement": "The test delivery did not match the agreed specification."
      },
      "requiredConfirmations": [
        {
          "side": "claimant",
          "principalId": "principal_test_123",
          "required": true,
          "statement": "The test delivery did not match the agreed specification."
        }
      ],
      "declaration": {
        "declarantName": "Maya Chen",
        "declarantCapacity": "Individual party",
        "executionLocation": "Brussels, Belgium"
      },
      "scope": "scope_test",
      "expiresAt": "expiresAt_test",
      "procedureTerms": {
        "schemaVersion": "case-procedure-v1",
        "track": "ai_fast",
        "appealWaived": false,
        "waiverDisclosureVersion": "waiverDisclosureVersion_test",
        "waiverDisclosureHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "rulesVersion": "rulesVersion_test",
        "rulesHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "behaviorVersion": "behaviorVersion_test",
        "disclosureVersion": "disclosureVersion_test",
        "disclosureHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "feePolicyVersion": "2026-08-test",
        "termsHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      }
    },
    "caseTrack": "ai_standard",
    "appealWaived": false,
    "procedureTerms": {
      "schemaVersion": "case-procedure-v1",
      "track": "ai_fast",
      "appealWaived": false,
      "waiverDisclosureVersion": "waiverDisclosureVersion_test",
      "waiverDisclosureHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "rulesVersion": "rulesVersion_test",
      "rulesHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "behaviorVersion": "behaviorVersion_test",
      "disclosureVersion": "disclosureVersion_test",
      "disclosureHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "feePolicyVersion": "2026-08-test",
      "termsHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    }
  },
  "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.