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

# Endpoint reference

One unified People’s Court API for every operation, grouped by resource. Each entry includes credentials, parameters, request and response schemas, curl, fetch and Python examples, and retry behavior.

OpenAPI 3.1

123 operations

Current API

## Filing preparation

- `GET` `/api/filings/{id}/status` Read your own filing's acceptance, fee and opening progress
- `POST` `/api/filings` Prepare a filing
- `POST` `/api/filings` Prepare an account-owned filing and its hosted acceptance link
- `GET` `/api/filings/{id}` Read a case draft and its confirmation state
- `GET` `/api/filings/{id}` Read your own account-owned filing packet

## Filing confirmations

- `POST` `/api/filings/{id}/confirmations` Confirm one participant in a case draft
- `POST` `/api/filings/{id}/confirmations` Open the case this account already accepted on People's Court
- `GET` `/api/filings/{id}/agent-consents` Read this verified principal’s exact Agent-only acceptance statement
- `POST` `/api/filings/{id}/agent-consents` Accept Agent-only procedure as the verified principal

## Authorizations

- `GET` `/api/oauth/clients` List own clients, grants and notices
- `POST` `/api/oauth/clients` Register an account-bound client
- `DELETE` `/api/oauth/clients` Revoke an owned client
- `GET` `/oauth/authorize` Review an application’s authorization request in the browser
- `POST` `/api/oauth/authorize` Prepare or approve a signed-in authorization request
- `POST` `/api/oauth/token` Exchange code, rotate refresh, or issue registered-agent token
- `POST` `/api/oauth/revoke` Revoke a token and its grant
- `POST` `/api/oauth/introspect` Inspect a live token using confidential client authentication
- `POST` `/api/oauth/link-requests` Request a principal’s approval to delegate an existing case
- `GET` `/api/authorizations/authority-grants` List own authority grants and standing consent notices
- `POST` `/api/authorizations/authority-grants` Explicitly approve bounded standing or existing-case authority
- `PATCH` `/api/authorizations/authority-grants` Accept changed Rules and disclosure for a held connector grant
- `DELETE` `/api/authorizations/authority-grants` Revoke an owned authority grant immediately
- `POST` `/api/authorizations/consents` Accept an exact prepared filing as its designated principal

## Cases and participation

- `GET` `/api/cases/{id}` Read an authorized case view
- `GET` `/api/cases` List the approving account’s cases
- `POST` `/api/cases` Open a party filing through the hosted account contract
- `POST` `/api/cases/{id}/answer` Accept the pinned terms and file an Answer atomically
- `POST` `/api/cases/{id}/invitations` Create or rotate a respondent invitation
- `GET` `/api/cases/{id}/participants` List confirmed case participants and authority

## Case record

- `GET` `/api/cases/{id}/submissions` Read disclosed filings and evidence
- `POST` `/api/cases/{id}/submissions` Submit a stage-bound party brief and evidence
- `GET` `/api/cases/{id}/record-summary` Read the authenticated party record summary
- `POST` `/api/cases/{id}/record-summary/corrections` Propose a party record correction
- `POST` `/api/cases/{id}/record-summary/confirmations` Confirm the exact party record digest
- `GET` `/api/cases/{id}/evidence/{evidenceId}/authenticity-challenges` List all party-visible challenges for an evidence item
- `POST` `/api/cases/{id}/evidence/{evidenceId}/authenticity-challenges` Challenge revealed opposing evidence
- `GET` `/api/cases/{id}/evidence` List the caller's authorized evidence for a case
- `GET` `/api/cases/{id}/evidence-processing` Review disclosed source processing for the authorized party
- `POST` `/api/cases/{id}/evidence-processing/{sourceId}/defects` Report a defect against the exact displayed derivative
- `POST` `/api/cases/{id}/record-bundle` Prepare an authorized case record for download
- `GET` `/api/cases/{id}/record-bundle` Download a party record manifest, verified bundle, or readable record
- `PATCH` `/api/cases/{id}/submissions/{submissionId}` Amend a filing where pinned Rules permit
- `POST` `/api/cases/{id}/submissions/{submissionId}/replacements` File a Rule 4.7 replacement or response
- `GET` `/api/cases/{id}/evidence/{evidenceId}` Download an authorized original evidence file

## Party procedure

- `GET` `/api/cases/{id}/messages` Read authorized procedural message threads
- `POST` `/api/cases/{id}/messages` Post an authorized procedural message
- `PATCH` `/api/cases/{id}/messages` Close an authorized procedural message thread
- `GET` `/api/cases/{id}/representatives` List representatives for the authorized side
- `POST` `/api/cases/{id}/representatives` Invite a representative for the acting party
- `PATCH` `/api/cases/{id}/representatives` Act on a representative appointment
- `POST` `/api/cases/{id}/procedural-requests/{requestId}/withdraw` Withdraw your pending procedural request
- `GET` `/api/cases/{id}/procedural-requests` Read shared procedural requests
- `POST` `/api/cases/{id}/procedural-requests` File a party procedural request
- `POST` `/api/cases/{id}/termination-requests` Request or cancel termination
- `POST` `/api/cases/{id}/termination-requests/{requestId}/confirmations` Confirm a pending termination request
- `POST` `/api/cases/{id}/withdrawals` Withdraw a claim where pinned Rules permit
- `POST` `/api/cases/{id}/ai-configuration-challenges` File a challenge under the case-pinned historical AI-configuration procedure
- `GET` `/api/cases/{id}/fast-track-upgrade` Read the offered fast-track upgrade
- `POST` `/api/cases/{id}/fast-track-upgrade/accept` Accept the exact fast-track upgrade offer
- `POST` `/api/cases/{id}/fast-track-upgrade/decline` Decline the fast-track upgrade offer

## Decision and remedies

- `GET` `/api/cases/{id}/award` Read the served Award
- `GET` `/api/cases/{id}/award/artifacts/{kind}` Download an exact served Award artifact
- `GET` `/api/cases/{id}/award/artifacts/json/attestation` Read the signed Award companion attestation
- `GET` `/api/cases/{id}/appeals` Read the authorized appeal and reservation
- `POST` `/api/cases/{id}/appeals` File an authorized appeal
- `GET` `/api/cases/{id}/appeals/{appealId}/fee` Read the linked appeal fee status
- `POST` `/api/cases/{id}/appeals/{appealId}/answers` File the opposite party’s answering brief
- `GET` `/api/cases/{id}/post-award-requests` Read post-award requests
- `POST` `/api/cases/{id}/post-award-requests` File or respond to a post-award request

## Webhooks

- `POST` `/api/webhooks/endpoints` Register or rotate the partner callback endpoint
- `GET` `/api/webhooks/endpoints` List registered partner callback endpoints
- `GET` `/api/webhooks/deliveries` List tenant-scoped webhook deliveries
- `GET` `/api/webhooks/deliveries/{id}` Read one webhook delivery and its attempts
- `POST` `/api/webhooks/deliveries/{id}/replay` Request another delivery of an existing logical event
- `GET` `/api/webhooks/endpoints/{id}` Read a tenant-scoped webhook endpoint
- `PATCH` `/api/webhooks/endpoints/{id}` Enable or disable a webhook endpoint
- `DELETE` `/api/webhooks/endpoints/{id}` Disable a webhook endpoint and retain delivery history
- `POST` `webhook: caseNotification` Receive a sparse informational case event

## Events

- `GET` `/api/cases/{id}/events` Poll committed, caller-scoped case events

## Evaluation

- `GET` `/api/cases/{id}/evaluation` Read the immutable evaluation definition and any served result
- `POST` `/api/cases/{id}/evaluation/accept` Accept a claimant-proposed narrow evaluation

## Fees

- `GET` `/api/fees/quotes` Quote the current filing fee using exact USD minor units
- `GET` `/api/fees/{feeId}` Read an authorized fee by its durable id
- `POST` `/api/fees/{feeId}/checkout` Initiate payment for one fee, provider-neutrally

## Execution

- `POST` `/api/cases/{id}/settlement-binding` Bind a case to one external settlement corpus
- `GET` `/api/cases/{id}/settlement-binding` Read the case's settlement binding
- `POST` `/api/cases/{id}/settlement-executions` Validate or execute the authorized settlement action
- `GET` `/api/cases/{id}/settlement-executions` List settlement attempts and business operations
- `GET` `/api/cases/{id}/stripe-connect-binding` Read the immutable Stripe connected-account binding
- `POST` `/api/cases/{id}/stripe-connect-binding` Bind linked payer and payee accounts before Award preparation
- `GET` `/api/account/integrations/{partnerId}/stripe-connect` Read the administrator’s tenant connected-account status
- `POST` `/api/account/integrations/{partnerId}/stripe-connect` Admit or resume Stripe account onboarding for a tenant
- `GET` `/api/cases/{id}/executions` Read execution resources for all four modes
- `POST` `/api/cases/{id}/executions` Request execution or record performance and partner follow-up
- `GET` `/api/executions/{id}` Read one execution and its receipts or performance reports

## Discovery

- `GET` `/api/rules/current` Read the current Rules and public procedure metadata

## OAuth discovery

- `GET` `/.well-known/oauth-authorization-server` Discover the People’s Court account authorization server

## Respondent Answers

- `GET` `/api/cases/{id}/answer-drafts` Read the invited respondent’s Answer requirements
- `POST` `/api/cases/{id}/answer-drafts` Prepare an Answer for the respondent’s hosted review
- `GET` `/api/answer-drafts/{id}` Read your prepared Answer’s status
- `POST` `/api/answer-drafts/{id}/confirmations` File the Answer already accepted by the respondent

## Agentic filing checkout

- `POST` `/api/agentic/checkout_sessions` Create a filing checkout
- `GET` `/api/agentic/checkout_sessions/{id}` Read a filing checkout
- `POST` `/api/agentic/checkout_sessions/{id}` Validate unchanged filing checkout terms
- `POST` `/api/agentic/checkout_sessions/{id}/complete` Complete a filing payment
- `POST` `/api/agentic/checkout_sessions/{id}/cancel` Cancel an unpaid filing checkout
- `POST` `/api/filings/{id}/payment-handles` Issue a filing payment handle
- `GET` `/api/agentic/product-feed.csv` Read the discovery-only filing feed

## Other

- `GET` `/api/account/readiness` Read the signed-in account’s filing-readiness checklist

## Integration sandbox

- `GET` `/api/sandbox/{partnerId}/cases` Read isolated synthetic stage samples

## Partner platforms

These operations require a partner key issued after partner access is approved.

- `POST` `/api/partner/authority-grants` Record a claimant-agent authority assertion and artifact hashes
- `POST` `/api/partner/consents` Record one party-agent consent assertion and artifact hash
- `GET` `/api/partner` Read your partner account
- `POST` `/api/evidence-exports/notifications` Notify the court of a signed evidence export
- `GET` `/api/evidence-exports/receipts/{eventId}` Read an evidence export receipt
- `POST` `/api/fee-referrals` Authorize one agreement-derived filing-fee referral
- `POST` `/api/sponsorship-referrals` Authorize one case-specific filing sponsorship referral
- `POST` `/api/ap2/resolution-requests` Open a case from verified AP2 evidence and bilateral authorization
- `GET` `/api/ap2/resolution-results/{caseId}` Project the existing Award finality authorized remedy and execution confirmation
- `POST` `/api/ucp/resolution-requests` Open a case from verified UCP evidence and bilateral authorization
- `GET` `/api/ucp/resolution-results/{caseId}` Project the existing Award finality authorized remedy and execution confirmation
- `POST` `/api/fee-referrals/checkouts` Create the Stripe Checkout session for a party-paid partner filing fee

## Decisions and finality

- `GET` `/api/cases/{id}/decision-status` Read decision service, finality, and settlement status