List your connected OAuth clients

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`	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: validation_failed, api_version_unsupported, authentication_required, api_key_invalid, resource_not_found, dry_run_not_supported, rate_limited, internal_error.

At a glance#

Request#

Query parameters#

Response#

Examples#

Your connections#

Errors#