---
title: "Read a retained installation"
method: GET
path: "/api/plugin_installations/{id}"
tags: ["Installations"]
---

# Read a retained installation

`GET /api/plugin_installations/{id}`

## Request

- Base URL: `https://trmnl.com`
- URL: `https://trmnl.com/api/plugin_installations/{id}`
- Auth: HTTP bearer

## Response `200`

Installation

- object
  - `data` PluginInstallation
    - `id` string, uuid, required
    - `state` 'setup_required' | 'ready' | 'completed' | 'cancelled' | 'expired' | 'removed', required
    - `source` object, required
      - `kind` string, required
      - `id` integer, required
      - `revision` string, required
      - `choice_id` string, required
      - `device_id` integer
    - `plugin_setting_id` integer, nullable, required
    - `expires_at` string, date_time, required

---

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