---
title: "List connections"
method: GET
path: "/v1/connections"
tags: ["Owner"]
---

# List connections

`GET /v1/connections`

## Request

- Base URL: `https://api.vicem.ai`
- URL: `https://api.vicem.ai/v1/connections`
- Auth: HTTP bearer

## Response `200`

OK

- ListConnectionsResponse
  - `items` PutSecretConnectionResponse[], required
    - `id` string, required
    - `provider` 'google' | 'microsoft' | 'caldav' | 'slack' | 'teams' | 'hubspot' | 'jobber' | 'followupboss' | 'housecallpro' | 'highlevel' | 'ics' | 'cliogrow', required
    - `accountEmail` string, required
    - `purposes` string[], required
    - `status` 'active' | 'needs_reconnect' | 'revoked', required
    - `settings` object, required
      - `busyCalendarIds` string[]
      - `writeCalendarId` string
      - `bookHere` true
      - `categories` string[]
    - `createdAt` string, date-time, required
    - `lastSyncedAt` string, date-time, required
    - `sharing` boolean
    - `crm` object
      - `lastSentAt` string, date-time, required
      - `retrying` integer, required
      - `stuck` integer, required
      - `refused` integer
      - `refusedField` string, nullable
  - `available` object, required
    - `google` boolean, required
    - `microsoft` boolean, required
    - `caldav` boolean, required
    - `slack` boolean, required
    - `teams` boolean, required
    - `hubspot` boolean
    - `jobber` boolean
    - `followupboss` boolean
    - `housecallpro` boolean
    - `highlevel` boolean
    - `ics` boolean
    - `cliogrow` boolean
  - `bookingApp` 'square' | 'jane' | 'simplepractice' | 'jobber' | 'calendly' | 'other', nullable

## Other responses

- `401`: Missing, expired or invalid bearer token.
- `500`: Unexpected server error (reported to Sentry).

---

[API](https://skmtc.dev/vicem/apis/vicem-api.md) · [All operations](https://skmtc.dev/vicem/apis/vicem-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vicem/apis/vicem-api/revisions/9efcec07e5f4?raw)