> For the complete documentation index, see [llms.txt](https://peoplescourt.ai/llms.txt). This page is also available as Markdown.

# 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.

Reference

Filing preparation

GET

partial

`/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

Name

Location

Requirement

Schema

`id`

path

Required

{"type":"string"}

## Responses

### 200

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

application/json

```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

```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

```json
{
  "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](https://peoplescourt.ai/docs/api/errors.md) and [rate limits](https://peoplescourt.ai/docs/api/rate-limits.md) 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.

## Request examples

Use `https://peoplescourt.ai` with the test credential issued for your integration.

```sh
curl --request GET \
  --url 'https://peoplescourt.ai/api/filings/draft_test_123' \
  --header 'Authorization: Bearer COPY_ACCOUNT_OAUTH_TOKEN'
```

```ts
const response = await fetch("https://peoplescourt.ai/api/filings/draft_test_123", {
  method: "GET",
  headers: {
    "Authorization": "Bearer COPY_ACCOUNT_OAUTH_TOKEN"
  },
});
if (!response.ok) throw await response.json();
const result = await response.json();
```

```python
import requests

response = requests.get(
    "https://peoplescourt.ai/api/filings/draft_test_123",
    headers={
      "Authorization": "Bearer COPY_ACCOUNT_OAUTH_TOKEN"
    },
    timeout=30,
)
response.raise_for_status()
result = response.json()
```