---
title: "Get a project plugin installation and its repositories"
method: GET
path: "/api/v1/plugins/{plugin}/installations/{installationId}"
tags: ["Management"]
---

# Get a project plugin installation and its repositories

`GET /api/v1/plugins/{plugin}/installations/{installationId}`

## Request

- Base URL: `https://entire.io` (the document declares no server; this is the origin it was published from)
- URL: `https://entire.io/api/v1/plugins/{plugin}/installations/{installationId}`
- Auth: none declared

Requires project manage or GitHub org owner on the installation's project.

## Path parameters

- `installationId` string, required
- `plugin` string, required

## Response `200`

Installation

- object
  - `installation_id` string, required
  - `account` string, required
  - `created_at` string, required
  - `project_id` string, required
  - `repository_selection` 'all' | 'selected', required
  - `lifecycle_state` 'active' | 'suspended' | 'deleting', required
  - `suspended_at` string
  - `suspended_by` 'plugin' | 'customer': While suspended: the side that suspended it, which is the only one that resumes.
  - `permissions` string[], required: The permissions the installation holds, as resource:access.
  - `pending_permissions` string[], required: The plugin's permissions that wait for a project manager to accept them.
  - `repositories` object[], required: A selection's repositories. Empty for all repositories, which are the project's.
    - `id` string, required
    - `full_name` string, required

## Other responses

- `400`: Invalid request
- `401`: Not authenticated
- `403`: Access denied
- `404`: Resource not found
- `409`: Resource conflict
- `412`: Precondition failed
- `422`: Validation failed
- `429`: Too many requests
- `502`: Entire Core request failed
- `503`: Entire Core is unavailable

## Changes

- **2026-10-27** `b5f5651bc1a0`: 2 info
  - added the required property `pending_permissions` to the response with the `200` status
  - added the required property `permissions` to the response with the `200` status
- **2026-10-20** `a74bcf174bd5`: 3 info
  - added the optional property `suspended_at` to the response with the `200` status
  - added the optional property `suspended_by` to the response with the `200` status
  - added the required property `lifecycle_state` to the response with the `200` status
- **2026-10-08** `d755dd67ad29`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/entire/apis/entire-api/changes/api/v1/plugins/:plugin/installations/:installationId/get.md)

---

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