---
title: "Get the histories of a shared policy group"
method: GET
path: "/shared-policy-groups/{sharedPolicyGroupId}/histories"
tags: ["SharedPolicyGroups"]
---

# Get the histories of a shared policy group

`GET /shared-policy-groups/{sharedPolicyGroupId}/histories`

## Path parameters

- `sharedPolicyGroupId` string, required

## Query parameters

- `page` integer
- `perPage` integer
- `sortBy` 'version' | '-version' | 'updatedAt' | '-updatedAt' | 'deployedAt' | '-deployedAt'

## Response `200`

Page of shared policy group histories

- object
  - `data` SharedPolicyGroup[] — List of SharedPolicyGroup.
    - `id` string — The unique ID of the shared policy group
    - `crossId` string — The unique ID of the shared policy group
    - `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.
    - `version` number — The version of the shared policy group
    - `apiType` 'A2A_PROXY' | 'AUTHZ' | 'EDGE' | 'LLM_PROXY' | 'MCP_PROXY' | 'MESSAGE' | 'PROXY' | 'NATIVE' — API's type.
    - `originContext` BaseOriginContext
      - `origin` 'MANAGEMENT' | 'KUBERNETES' | 'INTEGRATION' — The origin of the API.
    - `steps` StepV4[] — The list of steps (policies) in the shared policy group
      - `name` string — The name of the step
      - `description` string — The description of the step
      - `enabled` boolean — Is the step enabled or not.
      - `policy` string — The policy of the step
      - `configuration` object — The configuration of the step
      - `condition` string — The condition of the step
      - `messageCondition` string — The message condition of the step
    - `phase` 'ENTRYPOINT_CONNECT' | 'REQUEST' | 'RESPONSE' | 'INTERACT' | 'PUBLISH' | 'SUBSCRIBE' — The execution phase of a policy.
    - `deployedAt` string, date-time — The date at which the shared policy group was deployed
    - `createdAt` string, date-time — The date at which the shared policy group was created
    - `updatedAt` string, date-time — The date at which the shared policy group was last updated
    - `lifecycleState` 'DEPLOYED' | 'UNDEPLOYED' | 'PENDING' — The lifecycle state of a shared policy group
  - `pagination` Pagination — Generic object to handle pagination data.
    - `page` integer — The current page.
    - `perPage` integer — The number of items requested per page.
    - `pageCount` integer — The total number of pages.
    - `pageItemsCount` integer — The number of items for the current page.
    - `totalCount` integer — The total number of items, or `-1` if the count could not be computed within the configured timeout.
  - `links` Links — List of links for pagination
    - `self` string — Link to current resource
    - `first` string — In a paginated response, link to the first page
    - `last` string — In a paginated response, link to the last page
    - `previous` string — In a paginated response, link to the previous page. Maybe null if current is the first page
    - `next` string — In a paginated response, link to the next page. Maybe null if current is the last page

## Other responses

- `default` — Generic error response

---

[API](https://skmtc.net/gravitee-io/apis/gravitee-io-apim-management-api-environments.md) · [All operations](https://skmtc.net/gravitee-io/apis/gravitee-io-apim-management-api-environments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gravitee-io/gravitee-io-apim-management-api-environments/versions/37e8cbe5f769/schema)