> ## 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 |