---
title: "Get a Policy"
method: GET
path: "/policies/{policy}"
tags: ["policies"]
---

# Get a Policy

`GET /policies/{policy}`

## Request

- Base URL: `https://example.scalr.io/api/iacp/v3`
- URL: `https://example.scalr.io/api/iacp/v3/policies/{policy}`
- Auth: HTTP bearer

Show details of a specific OPA policy.

## Path parameters

- `policy` string, required

## Response `200`

Success.

- PolicyDocument: JSON:API Document. see: https://jsonapi.org/format/#document-structure
  - `data` Policy: A policy provides details of a single OPA policy as declared in [scalr-policy.hcl](../../opa.html#creating-policy-groups).
    - `attributes` object
      - `enabled` boolean: If set to `false`, the policy will not be evaluated during a run.
      - `enforced-level` 'hard-mandatory' | 'soft-mandatory' | 'advisory': The policy's enforcement level. * `hard-mandatory` - cannot be overridden. * `soft-mandatory` - can be overridden through an approval by account admins and other authorized roles. * `advisory` - provides a warning only.
      - `name` string: The name of the policy.
    - `id` string
    - `links` object
      - `self` string
    - `relationships` object
      - `policy-group` object: The policy group this policy belongs to.
        - `data` object, nullable, required
          - `id` string, required
          - `type` 'policy-groups' | '', required
    - `type` 'policies', required
  - `included` object[]
  - `meta` object

## Other responses

- `403`: User unauthorized to perform this action.
- `404`: User not authorized or policy not found.
- `4XX`: Client error.
- `5XX`: Server error.

---

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