List Connections - Verso Fetch

`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

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

Response

{
  "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