---
title: "Read a fleet"
method: GET
path: "/api/apps/fleet/{installation_id}"
tags: ["Apps - Fleet"]
---

# Read a fleet

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

## Request

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

The master device, how many mirrors need a push, the settings mirrors inherit and the overdue alert. listFleetDevices has each member.

## Response `200`

Success

- object
  - `data` Fleet
    - `id` string, uuid
    - `name` string
    - `master` FleetMember
      - `device_id` integer
      - `name` string, nullable
      - `role` 'master' | 'mirror'
      - `check_in_state` 'overdue' | 'on_time' | 'asleep' | 'never_seen', nullable: Whether the device checked in when it said it would; null for a device that was reset
      - `expected_check_in_at` string, date_time, nullable
      - `last_pushed_at` string, date_time, nullable
      - `in_sync` boolean: Pushed since the master playlist last changed
    - `mirror_count` integer
    - `needs_push_count` integer: Mirrors not pushed since the master playlist last changed
    - `overdue_count` integer
    - `last_pushed_at` string, date_time, nullable
    - `inherited_settings` string[]: Master settings each push copies to the mirrors
    - `alerts` object
      - `enabled` boolean
      - `threshold_minutes` integer
      - `email` string, nullable

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