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

# Get a Microsoft calendar board

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

## Request

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

Get a meeting-room summary for a connected Microsoft 365 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. The response has the same shape as the Google calendar room board.

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

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