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

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

Reference

Filing confirmations

POST

partial

`/api/filings/{id}/confirmations`

`confirmAccountFiling`

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

`Idempotency-Key`

header

Required

{"type":"string","minLength":8,"maxLength":200}

## Request body

Optional request body.

application/json

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

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

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

```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",
    "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](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.
- 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.

## Request examples

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

```sh
curl --request POST \
  --url 'https://peoplescourt.ai/api/filings/draft_test_123/confirmations' \
  --header 'Authorization: Bearer COPY_ACCOUNT_OAUTH_TOKEN' \
  --header 'Idempotency-Key: idem_test_12345678' \
  --header 'Content-Type: application/json' \
  --data '{}'
```

```ts
const input = {};

const response = await fetch("https://peoplescourt.ai/api/filings/draft_test_123/confirmations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer COPY_ACCOUNT_OAUTH_TOKEN",
    "Idempotency-Key": "idem_test_12345678",
    "Content-Type": "application/json"
  },
  body: JSON.stringify(input),
});
if (!response.ok) throw await response.json();
const result = await response.json();
```

```python
import requests

response = requests.post(
    "https://peoplescourt.ai/api/filings/draft_test_123/confirmations",
    headers={
      "Authorization": "Bearer COPY_ACCOUNT_OAUTH_TOKEN",
      "Idempotency-Key": "idem_test_12345678",
      "Content-Type": "application/json"
    },
    json={},
    timeout=30,
)
response.raise_for_status()
result = response.json()
```