# Query the connection list

Query the agent connections saved in the current workspace.

```text
GET $CLOUDSIGMA_API_BASE/workspaces/{workspace_id}/connections
```

## Before you call this API

Configure the [regional API endpoint and authentication](https://omnifabric.cloudsigma.com/docs/developer/endpoints-and-authentication.html.md), and select the target workspace.

The example below uses `$CLOUDSIGMA_API_KEY` and `$WORKSPACE_ID`.

## Request example

```bash
curl "$CLOUDSIGMA_API_BASE/workspaces/$WORKSPACE_ID/connections" -H "X-API-Key: $CLOUDSIGMA_API_KEY" -H "X-Workspace-ID: $WORKSPACE_ID"
```

## Successful response

Returns `200` and the connection list on success.

```json
{"code":0,"data":{"items":[],"total":0}}
```

The response fields are as follows.

| Field | Type | Description |
| --- | --- | --- |
| `data.items` | array | Current page connection. |
| `data.total` | integer | The total number of matches. |

## Error response

```json
{"code":6,"message":"unauthenticated"}
```