# List your connected OAuth clients

> The oauth_connections.list operation: GET /api/v1/oauth_connections in the REST API and the oauth_connections_list tool in the MCP server.

Lists the OAuth clients (such as MCP clients) that act for you, with the organizations and scopes you connected them to, most recently changed first (at most 100). App installations aren't listed here: see `app_installations.list`.

## At a glance

- **REST:** `GET /api/v1/oauth_connections`
- **MCP tool:** `oauth_connections_list`
- **Operation ID:** `oauth_connections.list`
- **Scope:** Platform
- **Permission:** `account:read`
- **Risk tier:** `read`
- **Dry run:** Not supported
- **Idempotency:** Not needed (read only)
- **Modes:** Test and live
- **Authentication:** API key with the `account:read` scope
- **Since:** M10

## Request

### Query parameters

This operation takes no query parameters.

## Response

`200 OK` with a JSON object:

| Field                       | Type                                                                                               | Description |
| --------------------------- | -------------------------------------------------------------------------------------------------- | ----------- |
| `object`                    | `"list"`                                                                                           |             |
| `data`                      | array of object                                                                                    |             |
| `data[].id`                 | string                                                                                             |             |
| `data[].object`             | `"oauth_connection"`                                                                               |             |
| `data[].client`             | object                                                                                             |             |
| `data[].client.id`          | `ocl_…` ID                                                                                         |             |
| `data[].client.name`        | string                                                                                             |             |
| `data[].client.publisher`   | string                                                                                             |             |
| `data[].client.dynamic`     | boolean                                                                                            |             |
| `data[].orgs`               | array of object                                                                                    |             |
| `data[].orgs[].orgId`       | `org_…` ID                                                                                         |             |
| `data[].orgs[].scopes`      | array of one of 84 values, e.g. `org:read`, `org:write`, `org:admin` (all in the OpenAPI document) |             |
| `data[].orgs[].consentedAt` | string                                                                                             |             |
| `data[].createdAt`          | string                                                                                             |             |
| `data[].updatedAt`          | string                                                                                             |             |

## Examples

### Your connections

```http
GET /api/v1/oauth_connections
Authorization: Bearer or_test_…
```

Response (`200`):

```json
{
  "object": "list",
  "data": [
    {
      "id": "ogr_01m4ttwd3veh9apbewxheq5xhd",
      "object": "oauth_connection",
      "client": {
        "id": "ocl_01m4ttwd3veh9apbewxheq5xhe",
        "name": "Claude",
        "publisher": "Unverified (registered by the client itself)",
        "dynamic": true
      },
      "orgs": [
        {
          "orgId": "org_01m4ttwd3veh9apbewxheq5xh3",
          "scopes": ["filings:read", "tasks:read"],
          "consentedAt": "2026-10-25T09:00:00.000Z"
        }
      ],
      "createdAt": "2026-10-25T09:00:00.000Z",
      "updatedAt": "2026-10-25T09:00:00.000Z"
    }
  ]
}
```

## Errors

| Code                                                                                   | HTTP status | When                                          | What to do                                                                      |
| -------------------------------------------------------------------------------------- | ----------- | --------------------------------------------- | ------------------------------------------------------------------------------- |
| [`permission_denied`](https://ownrecord.io/docs/reference/errors.md#permission_denied) | 403         | This isn't a signed-in person in the console. | Ask an organization owner or admin for a role or scope that allows this action. |

It can also return these [common errors](https://ownrecord.io/docs/reference.md#common-errors): [`validation_failed`](https://ownrecord.io/docs/reference/errors.md#validation_failed), [`api_version_unsupported`](https://ownrecord.io/docs/reference/errors.md#api_version_unsupported), [`authentication_required`](https://ownrecord.io/docs/reference/errors.md#authentication_required), [`api_key_invalid`](https://ownrecord.io/docs/reference/errors.md#api_key_invalid), [`resource_not_found`](https://ownrecord.io/docs/reference/errors.md#resource_not_found), [`dry_run_not_supported`](https://ownrecord.io/docs/reference/errors.md#dry_run_not_supported), [`rate_limited`](https://ownrecord.io/docs/reference/errors.md#rate_limited), [`internal_error`](https://ownrecord.io/docs/reference/errors.md#internal_error).