---
title: "Get Policy by ID"
method: GET
path: "/api/policy-engine/policies/{id}"
tags: ["Policy"]
---

# Get Policy by ID

`GET /api/policy-engine/policies/{id}`

Retrieves general information of a policy by its ID.

## Path parameters

- `id` string, required

## Headers

- `Content-Type` string, required
- `Accept` string, required

## Response `200`

- PolicyGetResponse[]
  - `id` string — Policy ID
  - `name` string — Policy Name
  - `description` string — Policy description. This description is only for internal use of identification
  - `statements` StatementGetResponse[] — Requirements to the Policy be applied
    - `effect` string, required — This field is not functional at the moment. To create a correct request, fill the field with `Allow`
    - `actions` unknown[] — Actions that the Policy will execute
      - unknown
    - `resource` string — Scope on which this policy must be evaluated
    - `condition` object — Condition to activate this policy. This object can have a maximum of ten recursive conditions
      - `conditions` object[] — List of conditions that will activate the policy
        - `conditions` string[] — These are the conditions the actions can have. The possible values are `[]`, `stringEquals`, and `numericGreaterThan`
        - `operation` string — The action of the condition. This operation possible values are `None`, `stringEquals`, `stringEqualsIgnoreCase`, `numericEquals`, `numericLessThan`, `numericLessThanEquals`, `numericGreaterThan`, `numericGreaterThanEquals`, `bool`, `not`, `or`, `and`, `dateTimeUtcGreaterThan`, `dateTimeUtcLessThan`, and `between`
        - `key` string — The element that will define what the policy will influence. This field has the possible values `skuId`, `brandId`, `discountPercentage`
        - `values` string[] — Value of the key
    - `operation` string — This operation will determine if all the conditions need to be valid or at least one of them, if the conditions array is not empty. The possible values to these fields are `None`, `stringEquals`, `stringEqualsIgnoreCase`, `numericEquals`, `numericLessThan`, `numericLessThanEquals`, `numericGreaterThan`, `numericGreaterThanEquals`, `bool`, `not`, `or`, `and`, `dateTimeUtcGreaterThan`, `dateTimeUtcLessThan`, and `between`

---

[API](https://skmtc.dev/vtex/apis/policies-system-api.md) · [All operations](https://skmtc.dev/vtex/apis/policies-system-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vtex/policies-system-api/revisions/b4e243ab2006/schema)