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

# List Connections

> List all connections for a user.

## `GET /api/conversations?userRef=`

Lists all connections for a given user within your app. Each connection includes the provider, status, sync timestamps, and conversation count.

## Request

**Headers**

| Header          | Value                    |
| --------------- | ------------------------ |
| `Authorization` | `Bearer YOUR_APP_SECRET` |

**Query parameters**

| Param     | Type     | Required | Description                   |
| --------- | -------- | -------- | ----------------------------- |
| `userRef` | `string` | Yes      | Your internal user identifier |

**Example**

```bash theme={null}
curl -s https://connect.tryverso.ai/api/conversations \
  -H "Authorization: Bearer $VERSO_SECRET" \
  -G -d "userRef=user_123"
```

## Response

```json theme={null}
{
  "connections": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "provider": "chatgpt",
      "status": "active",
      "capturedAt": "2026-09-20T10:00:00Z",
      "lastSyncAt": "2026-09-27T03:00:12Z",
      "conversationCount": 142
    }
  ],
  "userRef": "user_123"
}
```

| Field                             | Type      | Description                                |
| --------------------------------- | --------- | ------------------------------------------ |
| `connections`                     | `array`   | List of connections                        |
| `connections[].id`                | `string`  | Connection UUID                            |
| `connections[].provider`          | `string`  | LLM provider (e.g. `chatgpt`)              |
| `connections[].status`            | `string`  | `active`, `needs_reauth`, or `revoked`     |
| `connections[].capturedAt`        | `string`  | ISO 8601 timestamp of initial connection   |
| `connections[].lastSyncAt`        | `string?` | ISO 8601 timestamp of last successful sync |
| `connections[].conversationCount` | `number`  | Total imported conversations               |
| `userRef`                         | `string`  | The user ref from the request              |

Results are ordered by `captured_at` descending (newest first).

## Errors

| Status | Error                          | Cause                                    |
| ------ | ------------------------------ | ---------------------------------------- |
| 400    | `Missing userRef parameter`    | `userRef` query param not provided       |
| 401    | `Missing Authorization header` | Missing `Bearer` prefix                  |
| 401    | `Invalid API key`              | Wrong or missing app secret              |
| 404    | `User not found`               | No user with this `userRef` for your app |
| 429    | `Rate limit exceeded`          | Exceeded 60 requests/min                 |