---
title: "Get all shared policy group for a policy plugin usage"
method: GET
path: "/shared-policy-groups/policy-plugins"
tags: ["SharedPolicyGroups"]
---

# Get all shared policy group for a policy plugin usage

`GET /shared-policy-groups/policy-plugins`

## Request

- Base URL: `/management/v2/environments/DEFAULT` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/management/v2/environments/DEFAULT/shared-policy-groups/policy-plugins`
- Auth: one of:
  - HTTP basic
  - API key in cookie `Auth-Graviteeio-APIM`

## Response `200`

Shared policy group found

- SharedPolicyGroupPolicyPlugin[]
  - `id` string: The unique ID of the shared policy group
  - `policyId` string: The id of shared-policy-group plugin
  - `name` string: The name of the shared policy group
  - `description` string: The description of the shared policy group
  - `prerequisiteMessage` string: The prerequisite message of the shared policy group. This message is displayed to the user to help understand the prerequisite to use the shared policy group.
  - `apiType` 'A2A_PROXY' | 'AUTHZ' | 'EDGE' | 'LLM_PROXY' | 'MCP_PROXY' | 'MESSAGE' | 'PROXY' | 'NATIVE': API's type.
  - `phase` 'ENTRYPOINT_CONNECT' | 'REQUEST' | 'RESPONSE' | 'INTERACT' | 'PUBLISH' | 'SUBSCRIBE': The execution phase of a policy.

## Other responses

- `default`: Generic error response

## Changes

- **2026-06-19** `d1cab18ccf47`: 1 warning
  - added the new `AUTHZ` enum value to the `items/apiType` response property for the response status `200`
- **2026-05-22** `34e152417e4e`: 1 warning
  - added the new `EDGE` enum value to the `items/apiType` response property for the response status `200`
- **2026-02-13** `1c9b92e2e21c`: 1 info
  - removed the `CONNECT` enum value from the `items/phase` response property for the response status `200`
- **2026-02-03** `90e19a0ff082`: 1 warning
  - added the new `ENTRYPOINT_CONNECT` enum value to the `items/phase` response property for the response status `200`
- **2025-12-18** `84dd2985444a`: 1 warning
  - added the new `A2A_PROXY` enum value to the `items/apiType` response property for the response status `200`

[Operation history](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-environments/changes/shared-policy-groups/policy-plugins/get.md)

---

[API](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-environments.md) - [All operations](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-environments/llms.txt) - [OpenAPI document](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-environments/revisions/b736a7e375df?raw)
