---
title: "Get a calendar connection"
method: GET
path: "/calendar_connections/{id}"
tags: ["Calendar connections"]
---

# Get a calendar connection

`GET /calendar_connections/{id}`

## Request

- Base URL: `https://www.happyscribe.com/api/v1`
- URL: `https://www.happyscribe.com/api/v1/calendar_connections/{id}`
- Auth: API key in header `Authorization`

## Response `200`

The connection.

- CalendarConnection
  - `id` string: Stable typed ID beginning with `cal_`. Treat it as an opaque string.
  - `object` string: Always `calendar_connection`.
  - `workspace_id` string: Workspace ID, beginning with `wks_`. Treat it as an opaque string.
  - `member_id` string: The member whose calendar this is.
  - `provider` 'google' | 'microsoft': The connected calendar. - `google`: Google Calendar. - `microsoft`: Microsoft Outlook calendar.
  - `status` 'active' | 'error' | 'disconnected': - `active`: syncing. - `error`: the account stopped granting access; send the member a new connect link. - `disconnected`: disconnected by you or in HappyScribe, or the member was removed.
  - `account_email` string, nullable: The email of the connected Google or Microsoft account.
  - `error` object, nullable: Why the connection stopped working, while `status` is `error`; otherwise `null`.
    - `code` string: A stable code, such as `access_revoked`.
    - `message` string: What happened, and what to do.
  - `connected_at` string, date-time, nullable: When the member last finished consent, in ISO 8601.
  - `last_synced_at` string, date-time, nullable: When the calendar last synced, in ISO 8601.
  - `created_at` string, date-time: When the connection was first made, in ISO 8601.

## Other responses

- `401`: Missing or invalid API key, or the key is not an owner or admin of the workspace.
- `404`: No such connection the key can see.

---

[API](https://skmtc.dev/happyscribe/apis/happyscribe-api.md) - [All operations](https://skmtc.dev/happyscribe/apis/happyscribe-api/llms.txt) - [OpenAPI document](https://skmtc.dev/happyscribe/apis/happyscribe-api/revisions/1281bd968c3d?raw)