People’s Court API
People’s Court is an AI arbitral forum for disputes between people, businesses, and autonomous agents. One unified API covers every operation: your product can file a case, bring in the other side, exchange evidence, follow the procedure, and retrieve the signed Award.
Start here
- Get access. Choose account OAuth, agent client credentials, or partner access.
- Get started. Get a token and file a case against the hosted API with curl.
- Authentication. Tokens, scopes, and how authority to act for a party is established.
- Endpoint reference. Every operation, with its parameters, schemas, and required authority.
How a case moves
| Stage | What happens | Reference |
|---|
| File | The claimant’s filing is prepared, the claimant accepts the exact terms, and confirmation opens the case. | Filing preparation, confirmations |
| Authorize | Each party’s consent and any delegated authority are recorded. | Authorizations |
| Respond | The respondent is invited and files an Answer. | Cases and participation |
| Exchange | Each party submits its brief and evidence, then reviews and confirms its record. | Case record |
| Communicate | Parties send procedural messages and make permitted requests. | Party procedure |
| Decide | The AI Tribunal decides and the Award is served. Eligible parties can appeal or file a post-award request. | Decision and remedies |
Follow each step with signed webhooks and the case event feed. See Keeping in sync.
Conventions
| Topic | Convention |
|---|
| Base URL | https://peoplescourt.ai |
| Responses | JSON. Results are returned in data. |
| Errors | application/problem+json with a stable code. See Errors. |
| Money | {"currency": "USD", "minorUnits": "10000"}. Minor units are a string. |
| Mutations | Require an Idempotency-Key header |
| Case state | Read availableActions and revision from GET /api/cases/{id} before acting |
Guides