---
title: "List all Plugins"
url: "https://nov18-dev.movespot.fyi/apis/konnect-runtime-groups-configuration-0/versions/af18902c-58f1-49d7-8ec2-9987b4e0d1bd/operations/list-plugins"
---

> Full API specification: https://nov18-dev.movespot.fyi/apis/konnect-runtime-groups-configuration-0/versions/af18902c-58f1-49d7-8ec2-9987b4e0d1bd.md

# List all Plugins

`GET` `/runtime-groups/{runtimeGroupId}/core-entities/plugins`

Operation ID: `list-plugins`

This endpoint allows you to list all the plugins. You can use query parameters to filter the results by size or tags, for example `/plugins?size=50&tags=enterprise`.

## Path parameters

- `runtimeGroupId` (string, required) - The ID of your runtime group. This variable is available in the Konnect manager

## Query parameters

- `size` (integer, optional) - Number of resources to be returned.
- `offset` (string, optional) - Offset from which to return the next set of resources. Use the value of the 'offset' field from the response of a list operation as input here to paginate through all the resources
- `tags` (string, optional) - A list of tags to filter the list of resources on. Multiple tags can be concatenated using ',' to mean AND or using '/' to mean OR.

## Responses

- `200` - Example response

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Konnect Runtime Groups Configuration
  version: 0.0.1
servers:
  - url: https://us.api.konghq.com/v2
    description: United-States Production region
  - url: https://eu.api.konghq.com/v2
    description: Europe Production region
  - url: https://au.api.konghq.com/v2
    description: Australia Production region
  - url: https://me.api.konghq.com/v2
    description: Middle-East Production region
  - url: https://in.api.konghq.com/v2
    description: India Production region
  - url: https://sg.api.konghq.com/v2
    description: Singapore Production region
paths:
  /runtime-groups/{runtimeGroupId}/core-entities/plugins:
    parameters:
      - $ref: "#/components/parameters/runtimeGroupId"
    get:
      operationId: list-plugins
      summary: List all Plugins
      description: This endpoint allows you to list all the plugins. You can use query
        parameters to filter the results by size or tags, for example
        `/plugins?size=50&tags=enterprise`.
      parameters:
        - $ref: "#/components/parameters/pagination-size"
        - $ref: "#/components/parameters/pagination-offset"
        - $ref: "#/components/parameters/pagination-tags-filter"
      responses:
        "200":
          $ref: "#/components/responses/plugin-response"
      tags:
        - Plugins
security:
  - konnectAccessToken: []
  - personalAccessToken: []
components:
  parameters:
    runtimeGroupId:
      name: runtimeGroupId
      in: path
      required: true
      schema:
        type: string
        example: 9524ec7d-36d9-465d-a8c5-83a3c9390458
      description: The ID of your runtime group. This variable is available in the
        Konnect manager
    pagination-size:
      description: Number of resources to be returned.
      in: query
      name: size
      schema:
        type: integer
        default: 100
        maximum: 1000
        minimum: 1
    pagination-offset:
      description: Offset from which to return the next set of resources. Use the
        value of the 'offset' field from the response of a list operation as
        input here to paginate through all the resources
      in: query
      name: offset
      schema:
        type: string
    pagination-tags-filter:
      description: A list of tags to filter the list of resources on. Multiple tags
        can be concatenated using ',' to mean AND or using '/' to mean OR.
      example: tag1,tag2
      in: query
      name: tags
      schema:
        type: string
  responses:
    plugin-response:
      description: Example response
      content:
        application/json:
          schema:
            type: object
            properties:
              id:
                type: string
              name:
                description: The name of the Plugin that’s going to be added. Currently, the
                  Plugin must be installed in every Kong instance separately.
                type: string
                example: rate-limiting
              created_at:
                description: Unix epoch when the resource was created.
                type: integer
              route:
                description: "If set, the plugin will only activate when receiving requests via
                  the specified route. Leave unset for the plugin to activate
                  regardless of the route being used. Default: `null`.With
                  form-encoded, the notation is `route.id=<route id> or
                  route.name=<route name>`. With JSON, use `route:{id:<route
                  id>}` or `route:{name:<route name>}`."
                type: string
                nullable: true
              service:
                description: If set, the plugin will only activate when receiving requests via
                  one of the routes belonging to the specified service.
                type: string
                nullable: true
              consumer:
                description: If set, the plugin will activate only for requests where the
                  specified has been authenticated. (Note that some plugins can
                  not be restricted to consumers this way.)
                type: string
                nullable: true
              instance_name:
                description: |
                  The Plugin instance name.
                type: string
                example: rate-limiting-foo
              config:
                description: The configuration properties for the Plugin
                type: object
                properties:
                  hour:
                    type: integer
                    example: 500
                  minute:
                    type: integer
                    example: 500
              protocols:
                description: A list of the request protocols that will trigger this plugin.
                type: array
                items:
                  type: string
                  enum:
                    - http
                    - grpc
                    - grpcs
                    - tls
                    - tcp
                  default: http
              enabled:
                description: |
                  Whether the plugin is applied. Default: `true`.
                type: boolean
                default: true
              tags:
                description: >
                  An optional set of strings associated with the Plugin for
                  grouping and filtering.
                type: array
                items:
                  type: string
          x-examples:
            Example 1:
              id: ce44eef5-41ed-47f6-baab-f725cecf98c7
              name: rate-limiting
              created_at: 1422386534
              route: null
              service: null
              consumer: null
              instance_name: rate-limiting-foo
              config:
                hour: 500
                minute: 20
              protocols:
                - http
                - https
              enabled: true
              tags:
                - user-level
                - low-priority
              ordering:
                before:
                  - plugin-name
          examples:
            Plugin response:
              value:
                data:
                  - id: 02621eee-8309-4bf6-b36b-a82017a5393e
                    name: rate-limiting
                    created_at: 1422386534
                    route: null
                    service: null
                    consumer: null
                    config:
                      hour: 500
                      minute: 20
                    protocols:
                      - http
                      - https
                    enabled: true
                    tags:
                      - user-level
                      - low-priority
                    ordering:
                      before:
                        - plugin-name
                  - id: 66c7b5c4-4aaf-4119-af1e-ee3ad75d0af4
                    name: rate-limiting
                    created_at: 1422386534
                    route: null
                    service: null
                    consumer: null
                    config:
                      hour: 500
                      minute: 20
                    protocols:
                      - tcp
                      - tls
                    enabled: true
                    tags:
                      - admin
                      - high-priority
                      - critical
                next: http://localhost:8001/plugins?offset=6378122c-a0a1-438d-a5c6-efabae9fb969
  securitySchemes:
    konnectAccessToken:
      type: http
      scheme: bearer
      description: >-
        The Konnect access token is meant to be used by the Konnect dashboard
        and the decK CLI to

        authenticate with.
    personalAccessToken:
      type: http
      scheme: bearer
      description: The personal access token is meant to be used as an alternative to
        basic-auth when accessing Konnect via APIs. You can generate a Personal
        Access Token (PAT) from the personal access token page in the Konnect
        dashboard.
```
