> ## Documentation Index
> Fetch the complete documentation index at: https://docs.opsmatic.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Connection

> Retrieve a single connection by ID

## Get Connection

Returns one connection with its status and masked credentials.

```
GET https://api.opsmatic.com/v1/connections/{id}
```

Requires an API key with `connections: read` and access to the connection.

### Path Parameters

<ParamField path="id" type="string" required>
  The connection ID, e.g. `conn_abc123`.
</ParamField>

### Headers

<ParamField header="Authorization" type="string" required>
  `Bearer ops_your_api_key`
</ParamField>

### Response

<ResponseField name="id" type="string">
  Unique connection identifier.
</ResponseField>

<ResponseField name="service_type" type="string">
  `n8n`, `make` or `openclaw`.
</ResponseField>

<ResponseField name="service_name" type="string">
  The friendly label for the connection.
</ResponseField>

<ResponseField name="status" type="string">
  `active`, `inactive` or `error`.
</ResponseField>

<ResponseField name="api_key" type="string | null">
  Masked credential (never returned in plaintext).
</ResponseField>

<ResponseField name="organization_id" type="string | null">
  The organization this connection belongs to, or `null` for a personal connection.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer ops_your_api_key" \
    https://api.opsmatic.com/v1/connections/conn_abc123
  ```

  ```javascript Node theme={null}
  const res = await fetch(
    "https://api.opsmatic.com/v1/connections/conn_abc123",
    { headers: { Authorization: "Bearer ops_your_api_key" } }
  );
  const connection = await res.json();
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "conn_abc123",
    "service_type": "n8n",
    "service_name": "Production n8n",
    "status": "active",
    "base_url": "https://n8n.example.com",
    "api_key": "****************",
    "organization_id": "org_789",
    "created_at": "2026-01-01T00:00:00Z"
  }
  ```

  ```json 404 theme={null}
  { "error": "Connection not found" }
  ```
</ResponseExample>