---
title: "List of policy details fetched for given policy uris or policy ids"
method: POST
path: "/governance/guardrails/policies/batch"
tags: ["Guardrails"]
---

# List of policy details fetched for given policy uris or policy ids

`POST /governance/guardrails/policies/batch`

Fetch policy details for given policy uris or policy ids. Supports a maximum of 1000 results per request
Supports a maximum of 1000 results per request

## Request body

- PolicyRequest
  - `policy_uris` string[] — Unique URI for policy
  - `policy_ids` string[] — List of policy IDs to fetch policy details

## Response `200`

Success

- PolicyDescription[]
  - `uri` string — Unique URI for policy
  - `policy_id` string — Policy Id is unique identifier of a policy
  - `name` string — Policy name is unique identifier of a policy
  - `display_name` string — Display name of the policy
  - `description` string — A brief explanation of the policy
  - `parameters` NamedParameter[]
    - `name` string, required — Name of the parameter
    - `display_name` string — Display Name of the parameter
    - `is_required` boolean, required — Whether the parameter is required.
    - `schema` ParameterBase, required
      - `description` string — A brief explanation of the policy parameter
      - `default_value` string — Default value of the parameter, encoded as a JSON string
      - `hide_parameter` boolean — Hide/Show a parameter for visibility as part of deployment
      - `__type` string, required — Concrete type used for polymorphic deserialization (discriminator)
  - `created_at` string, date-time
  - `services` string[]
  - `engine_type` 'corestack_policy' | 'aws_organization_policy' | 'azure_policy' | 'aws_config' | 'gcp_organization_policy' | 'gcp_policy' | 'kubernetes_policy' | 'oracle_cloud_guard' — Engine type of the policy
  - `scope` 'global' | 'account' | 'tenant' | 'user_private' — Scope of the policy
  - `tenant_id` string — ID of the tenant within the CoreStack account
  - `account_id` string — Id of the CoreStack account under which this tenant resides.
  - `classification` string — Policies are classified based on the basis of the activity they perform. For example: Provisioning, Account Management, Utilization, etc.
  - `sub_classification` string — Sub classification for policy
  - `resource_category` string — Category of resource
  - `resource_type` string — Type of resource
  - `service_resources` string[] — Service resources of policy
  - `severity` 'critical' | 'high' | 'info' | 'low' | 'medium' | 'none' | 'unknown' — Severity of policy
  - `recommendation_description` string — Recommendation description of the policy
  - `recommendation_actions` PolicyRecommendationActions[] — Recommendation actions of the policy
    - `name` string — Name of the recommendation action
    - `description` string — Description of the recommendation action
    - `terms_and_conditions` string — T&C of the recommendation action
    - `preexecute_required` boolean — Flag to check if pre-execute is required or not
  - `equivalent_policies` string[] — Equivalent policy names

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

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