---
title: "Get a Google calendar board"
method: GET
path: "/v1/social/google-calendar/{accountId}/events"
tags: ["social"]
---

# Get a Google calendar board

`GET /v1/social/google-calendar/{accountId}/events`

## Request

- Base URL: `https://api.brixsignage.com`
- URL: `https://api.brixsignage.com/v1/social/google-calendar/{accountId}/events`
- Auth: none required

Get a meeting-room summary for a connected Google calendar: the current and next events, free time until the next booking, current busy status, and the day's agenda. Access requires a dt token, issued by the preview-token endpoint or provided automatically to a screen. If the stored access is no longer valid, it is refreshed automatically, and the last known result is served if the calendar cannot be reached.

**Notes.**
- Feed envelope: `stale` (and `staleSince`) beside `data`. Answers are cached at the edge for a few minutes.
- The connected calendar's next 24 hours as a room board: now, next, free until, agenda. Cancelled events are left out.

## Path parameters

- `accountId` string, required

## Query parameters

- `dt` string, required

## Response `200`

Success.

- object
  - `data` object, required
    - `now` object, nullable, required: The event on now, if any.
      - `title` string, required
      - `start` string, required: ISO-8601 timestamp (UTC).
      - `end` string, required: ISO-8601 timestamp (UTC).
    - `next` object, nullable, required
      - `title` string, required
      - `start` string, required: ISO-8601 timestamp (UTC).
      - `end` string, required: ISO-8601 timestamp (UTC).
    - `freeUntil` string, nullable, required: ISO-8601 timestamp (UTC).
    - `busy` boolean, required
    - `agenda` object[], required: The next 24 hours.
      - `title` string, required
      - `start` string, required: ISO-8601 timestamp (UTC).
      - `end` string, required: ISO-8601 timestamp (UTC).
  - `stale` boolean, required: True when the provider failed and this is the last good answer.
  - `staleSince` string: When the stale copy was fetched (only when `stale`).

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `404`: No such account, or the `dt` token is missing, expired or for another workspace.
- `502`: The provider failed and there is no recent copy to serve.
- `5XX`: Server error. The body carries a `requestId` to quote to support.

---

[API](https://skmtc.dev/brixsignage/apis/brix-api.md) · [All operations](https://skmtc.dev/brixsignage/apis/brix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/brixsignage/apis/brix-api/revisions/02fd3665dc7d?raw)