---
title: "List service connections and their health"
method: GET
path: "/v3/organizations/{orgId}/connections"
tags: ["Connections"]
---

# List service connections and their health

`GET /v3/organizations/{orgId}/connections`

## Request

- Base URL: `https://api.reasonmachines.com`
- URL: `https://api.reasonmachines.com/v3/organizations/{orgId}/connections`
- Auth: HTTP bearer

<sub>Scope: `mcp:read`</sub>

## Response `200`

Grouped connection services with individual accounts, methods, health evidence and supported actions.

- object
  - `services` object[], required
    - `id` string, required
    - `name` string, required
    - `icon` string, nullable, required
    - `description` string, required
    - `status` 'not_connected' | 'connected' | 'needs_attention', required
    - `reason` string, required
    - `connections` object[], required
      - `id` string, required
      - `recordId` string, required
      - `adapter` 'mcp' | 'native', required
      - `serviceId` string, required
      - `name` string, required
      - `accountId` string, nullable, required
      - `accountName` string, required
      - `ownerUserId` string, nullable, required
      - `scope` 'personal' | 'organization', required
      - `method` string, required
      - `capabilities` string[], required
      - `auth` object, required
        - `type` string, required
        - `authorized` boolean, nullable, required
      - `status` 'not_connected' | 'connected' | 'needs_attention', required
      - `reason` string, required
      - `checkedAt` string, nullable, required
      - `lastSuccessfulCheckAt` string, nullable, required
      - `canManage` boolean, required
      - `pending` boolean, required
      - `actions` object, required
        - `check` object, required
          - `supported` boolean, required
          - `reason` string, nullable, required
        - `reconnect` object, required
          - `supported` boolean, required
          - `reason` string, nullable, required
        - `disconnect` object, required
          - `supported` boolean, required
          - `reason` string, nullable, required
        - `remove` object, required
          - `supported` boolean, required
          - `reason` string, nullable, required
        - `cancel` object, required
          - `supported` boolean, required
          - `reason` string, nullable, required
    - `offerings` object[], required
      - `id` string, required
      - `adapter` 'mcp' | 'native', required
      - `providerId` string, required
      - `name` string, required
      - `connectable` boolean, required
      - `reason` string, nullable, required

## Other responses

- `401`: Missing, invalid, or expired key.
- `403`: The key lacks the required scope or role.
- `429`: Too many requests. Retry after the number of seconds in the `Retry-After` response header.

## Changes

- **2026-10-16** `c1c5937b9102`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ara/apis/reason-api/changes/v3/organizations/:orgId/connections/get.md)

---

[API](https://skmtc.dev/ara/apis/reason-api.md) - [All operations](https://skmtc.dev/ara/apis/reason-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ara/apis/reason-api/revisions/e97c8704807c?raw)