---
title: "GET /policy-engines/{policyEngineId}"
method: GET
path: "/policy-engines/{policyEngineId}"
---

# GET /policy-engines/{policyEngineId}

`GET /policy-engines/{policyEngineId}`

Retrieves detailed information about a specific policy engine within the AgentCore Policy system. This operation returns the complete policy engine configuration, metadata, and current status, allowing administrators to review and manage policy engine settings.

## Path parameters

- `policyEngineId` string, required

## Response `200`

Success

- GetPolicyEngineResponse
  - `policyEngineId` string, required — The unique identifier of the retrieved policy engine. This matches the policy engine ID provided in the request and serves as the system identifier.
  - `name` string, required — The customer-assigned name of the policy engine. This is the human-readable identifier that was specified when the policy engine was created.
  - `createdAt` string, date-time, required — The timestamp when the policy engine was originally created.
  - `updatedAt` string, date-time, required — The timestamp when the policy engine was last modified. This tracks the most recent changes to the policy engine configuration.
  - `policyEngineArn` string, required — The Amazon Resource Name (ARN) of the policy engine. This globally unique identifier can be used for cross-service references and IAM policy statements.
  - `status` 'CREATING' | 'ACTIVE' | 'UPDATING' | 'DELETING' | 'CREATE_FAILED' | 'UPDATE_FAILED' | 'DELETE_FAILED', required — The current status of the policy engine.
  - `encryptionKeyArn` string — The Amazon Resource Name (ARN) of the KMS key used to encrypt the policy engine data.
  - `description` string, password — The human-readable description of the policy engine's purpose and scope. This helps administrators understand the policy engine's role in governance.
  - `statusReasons` String[], required — Additional information about the policy engine status. This provides details about any failures or the current state of the policy engine.

## Other responses

- `480` — AccessDeniedException
- `481` — ValidationException
- `482` — ThrottlingException
- `483` — ResourceNotFoundException
- `484` — InternalServerException

---

[API](https://skmtc.net/aws/apis/bedrock-agentcore-control.md) · [All operations](https://skmtc.net/aws/apis/bedrock-agentcore-control/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/bedrock-agentcore-control/versions/0ebde766792b/schema)