---
title: "Get a Plugin associated with a service"
url: "https://nov18-dev.movespot.fyi/apis/konnect-runtime-groups-configuration-0/versions/af18902c-58f1-49d7-8ec2-9987b4e0d1bd/operations/fetch-plugin-with-a-service"
---

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

# Get a Plugin associated with a service

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

Operation ID: `fetch-plugin-with-a-service`

Get a Plugin associated with a service using ID.

## Path parameters

- `service_id` (string, required) - ID **or** name of the service to lookup
- `plugin_id_or_instance_name` (string, required) - The unique identifier of the Plugin to create or update.
- `runtimeGroupId` (string, required) - The ID of your runtime group. This variable is available in the Konnect manager

## Query parameters

- `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
- `size` (integer, optional) - Number of resources to be returned.
- `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` - Successfully fetched Plugin
- `404` - Resource does not exist

## 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/services/{service_id}/plugins/{plugin_id_or_instance_name}:
    parameters:
      - $ref: "#/components/parameters/service_id"
      - $ref: "#/components/parameters/plugin_id_or_instance_name"
      - $ref: "#/components/parameters/runtimeGroupId"
    get:
      operationId: fetch-plugin-with-a-service
      summary: Get a Plugin associated with a service
      description: Get a Plugin associated with a service using ID.
      parameters:
        - $ref: "#/components/parameters/pagination-offset"
        - $ref: "#/components/parameters/pagination-size"
        - $ref: "#/components/parameters/pagination-tags-filter"
      responses:
        "200":
          description: Successfully fetched Plugin
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Plugin"
        "404":
          description: Resource does not exist
      tags:
        - Plugins
security:
  - konnectAccessToken: []
  - personalAccessToken: []
components:
  parameters:
    service_id:
      name: service_id
      description: ID **or** name of the service to lookup
      example: 7fca84d6-7d37-4a74-a7b0-93e576089a41
      in: path
      required: true
      schema:
        type: string
    plugin_id_or_instance_name:
      name: plugin_id_or_instance_name
      in: path
      required: true
      schema:
        type: string
        example: response-ratelimiting
      description: The unique identifier of the Plugin to create or update.
    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-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-size:
      description: Number of resources to be returned.
      in: query
      name: size
      schema:
        type: integer
        default: 100
        maximum: 1000
        minimum: 1
    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
  schemas:
    Plugin:
      description: A Plugin entity represents a plugin configuration that will be
        executed during the HTTP request/response lifecycle.
      type: object
      properties:
        config:
          description: The configuration properties for the Plugin which can be found on
            the plugins documentation page in the [Kong
            Hub](https://docs.konghq.com/hub/).
          type: object
        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.). Leave unset for the plugin to
            activate regardless of the authenticated Consumer.
          type: object
          additionalProperties: false
          properties:
            id:
              type: string
        created_at:
          description: Unix epoch when the resource was created.
          type: integer
        enabled:
          description: Whether the plugin is applied.
          type: boolean
          default: true
        id:
          type: string
        instance_name:
          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
        ordering:
          type: object
        protocols:
          description: A list of the request protocols that will trigger this plugin. The
            default value, as well as the possible values allowed on this field,
            may change depending on the plugin type. For example, plugins that
            only work in stream mode will only support `tcp` and `tls`.
          type: array
          items:
            type: string
          default:
            - grpc
            - grpcs
            - http
            - https
        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.
          type: object
          additionalProperties: false
          properties:
            id:
              type: string
        service:
          description: If set, the plugin will only activate when receiving requests via
            one of the routes belonging to the specified service. Leave unset
            for the plugin to activate regardless of the service being matched.
          type: object
          additionalProperties: false
          properties:
            id:
              type: string
        tags:
          description: An optional set of strings associated with the Plugin for grouping
            and filtering.
          type: array
          items:
            type: string
      example:
        config:
          anonymous: null
          hide_credentials: false
          key_in_body: false
          key_in_header: true
          key_in_query: true
          key_names:
            - apikey
          run_on_preflight: true
        enabled: true
        id: 3fd1eea1-885a-4011-b986-289943ff8177
        name: key-auth
        protocols:
          - grpc
          - grpcs
          - http
          - https
      title: Plugin
  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.
```
