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

# Discover the People’s Court account authorization server

Discover the People’s Court account authorization server

Reference

Account OAuth

GET

live

`/.well-known/oauth-authorization-server`

`getAccountOAuthMetadata`

## Authentication and authority

No bearer credential is required.

## Parameters

This operation has no path, query, or header parameters.

## Responses

### 200

Successful operation.

application/json

```json
{
  "type": "object",
  "properties": {
    "issuer": {
      "type": "string"
    },
    "authorization_endpoint": {
      "type": "string"
    },
    "token_endpoint": {
      "type": "string"
    },
    "revocation_endpoint": {
      "type": "string"
    },
    "introspection_endpoint": {
      "type": "string"
    },
    "response_types_supported": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "grant_types_supported": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "code_challenge_methods_supported": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "token_endpoint_auth_methods_supported": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "scopes_supported": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "cases:read",
          "fees:agentic:write",
          "executions:report",
          "filings:write",
          "answers:write",
          "submissions:write",
          "records:confirm",
          "records:write",
          "invitations:write",
          "messages:write",
          "remedies:write",
          "representatives:manage",
          "procedural:request",
          "termination:write",
          "consents:write",
          "offline_access"
        ]
      }
    }
  }
}
```

### default

Authorization failure; consent_required requires explicit reacceptance.

application/json

```json
{
  "$ref": "#/components/schemas/AccountOAuthError",
  "type": "object",
  "properties": {
    "error": {
      "type": "string"
    },
    "error_description": {
      "type": "string"
    }
  },
  "required": [
    "error"
  ]
}
```

## Example response

### Successful response

```json
{}
```

## 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/.well-known/oauth-authorization-server'
```

```ts
const response = await fetch("https://peoplescourt.ai/.well-known/oauth-authorization-server", {
  method: "GET",
});
if (!response.ok) throw await response.json();
const result = await response.json();
```

```python
import requests

response = requests.get(
    "https://peoplescourt.ai/.well-known/oauth-authorization-server",
    timeout=30,
)
response.raise_for_status()
result = response.json()
```