---
title: "Read a room booking installation"
method: GET
path: "/api/apps/room_booking/{installation_id}"
tags: ["Apps - Room Booking"]
---

# Read a room booking installation

`GET /api/apps/room_booking/{installation_id}`

## Request

- Base URL: `https://trmnl.com`
- URL: `https://trmnl.com/api/apps/room_booking/{installation_id}`
- Auth: HTTP bearer

What is connected, how many calendars and collections there are, which devices show one, and the billing state. Google and Microsoft accounts are connected in the browser.

## Response `200`

Success

- object
  - `data` RoomBookingSummary
    - `id` string, uuid
    - `name` string
    - `timezone` string, nullable
    - `configured` boolean: An account is connected or a calendar exists
    - `connected_accounts` object
      - `google_user` integer
      - `google_workspace` integer
      - `microsoft_user` integer
      - `microsoft_workspace` integer
    - `calendar_count` integer
    - `collection_count` integer
    - `sync_error_count` integer: Calendars whose last fetch failed
    - `device_ids` integer[]: Devices showing a calendar or collection
    - `billing` object
      - `locked` boolean: Changes answer 402 until the subscription is settled
      - `subscription_required` boolean: Rooms reach a screen but nothing is subscribed yet
      - `subscription_status` string, nullable
      - `billing_url` string: Where the owner subscribes or manages the subscription, in the browser

## Other responses

- `401`: Unauthorized
- `404`: Installation belongs to another user

---

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