---
title: "List plugins"
method: GET
path: "/plugins"
tags: ["Plugin"]
---

# List plugins

`GET /plugins`

Returns information about installed plugins.

## Query parameters

- `filters` string

## Response `200`

No error

- Plugin[]
  - `Id` string
  - `Name` string, required
  - `Enabled` boolean, required — True if the plugin is running. False if the plugin is not running, only installed.
  - `Settings` object, required — Settings that can be modified by users.
    - `Mounts` PluginMount[], required
      - `Name` string, required
      - `Description` string, required
      - `Settable` string[], required
      - `Source` string, required
      - `Destination` string, required
      - `Type` string, required
      - `Options` string[], required
    - `Env` string[], required
    - `Args` string[], required
    - `Devices` PluginDevice[], required
      - `Name` string, required
      - `Description` string, required
      - `Settable` string[], required
      - `Path` string, required
  - `PluginReference` string — plugin remote reference used to push/pull the plugin
  - `Config` object, required — The config of a plugin.
    - `DockerVersion` string — Docker Version used to create the plugin
    - `Description` string, required
    - `Documentation` string, required
    - `Interface` object, required — The interface between Docker and the plugin
      - `Types` PluginInterfaceType[], required
        - `Prefix` string, required
        - `Capability` string, required
        - `Version` string, required
      - `Socket` string, required
      - `ProtocolScheme` '' | 'moby.plugins.http/v1' — Protocol to use for clients connecting to the plugin.
    - `Entrypoint` string[], required
    - `WorkDir` string, required
    - `User` object
      - `UID` integer
      - `GID` integer
    - `Network` object, required
      - `Type` string, required
    - `Linux` object, required
      - `Capabilities` string[], required
      - `AllowAllDevices` boolean, required
      - `Devices` PluginDevice[], required
        - `Name` string, required
        - `Description` string, required
        - `Settable` string[], required
        - `Path` string, required
    - `PropagatedMount` string, required
    - `IpcHost` boolean, required
    - `PidHost` boolean, required
    - `Mounts` PluginMount[], required
      - `Name` string, required
      - `Description` string, required
      - `Settable` string[], required
      - `Source` string, required
      - `Destination` string, required
      - `Type` string, required
      - `Options` string[], required
    - `Env` PluginEnv[], required
      - `Name` string, required
      - `Description` string, required
      - `Settable` string[], required
      - `Value` string, required
    - `Args` object, required
      - `Name` string, required
      - `Description` string, required
      - `Settable` string[], required
      - `Value` string[], required
    - `rootfs` object
      - `type` string
      - `diff_ids` string[]

## Other responses

- `500` — Server error

---

[API](https://skmtc.net/chapar-rest/apis/docker-engine-api.md) · [All operations](https://skmtc.net/chapar-rest/apis/docker-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chapar-rest/docker-engine-api/versions/3a78a994dd0d/schema)