---
title: "policy get"
method: GET
path: "/api/v1/systems/{system_id}/policies/{policy_id}/"
tags: ["open"]
---

# policy get

`GET /api/v1/systems/{system_id}/policies/{policy_id}/`

## Request

- The document declares no server URL.
- Auth: one of:
  - API key in header `X-Bk-App-Code`
  - API key in header `X-Bk-App-Secret`

get a policy

## Path parameters

- `system_id` string, required
- `policy_id` string, required

## Response `200`

OK

- object
  - `code` integer
  - `data` HandlerPolicyGetResponse
    - `action` IamPkgApiOpenHandlerPolicyResponseAction
      - `id` string
    - `expired_at` integer
    - `expression` object
    - `id` integer
    - `subject` IamPkgApiOpenHandlerPolicyResponseSubject
      - `id` string
      - `name` string
      - `type` string
    - `system` string
    - `version` string
  - `message` string

## Changes

- **2026-07-17** `f3a5fe2fe9c6`: 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added
- **2021-07-19** `361087436cc5`: 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added

[Operation history](https://skmtc.dev/tencentblueking/apis/iam-api/changes/api/v1/systems/:system_id/policies/:policy_id/get.md)

---

[API](https://skmtc.dev/tencentblueking/apis/iam-api.md) - [All operations](https://skmtc.dev/tencentblueking/apis/iam-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tencentblueking/apis/iam-api/revisions/f3a5fe2fe9c6?raw)