---
title: "GET /policy-events"
method: GET
path: "/policy-events"
tags: ["PolicyEvents"]
---

# GET /policy-events

`GET /policy-events`

Get policy events for given scope.

## Query parameters

- `scope` string, required
- `syncToken` string, required
- `api-version` string, required

## Response `200`

Success

- PolicyEventsResponseUpdated — Response model for policy delta fetch API.
  - `syncToken` string, required — This sync token represents the latest checkpoint for policies. Client need to pass this value while fetching subsequent delta changes.
  - `value` PolicyElementEventModelUpdated[] — List of policy elements.
    - `id` string, required — Id of the policy element.
    - `scopes` string[] — List of scopes included in this policy.
    - `version` integer, required — Current version of policy element. This is auto incremented with each change. Starts with 1.
    - `elementJson` string — Policy element serialized json payload.
    - `kind` 'Policy' | 'PolicySet' | 'AttributeRule', required — Represents the kind of policy element.
    - `updatedAt` string, date-time, required — Time at which this policy element was last updated.
    - `eventType` string, required — Type of event. Format: <RP-Name>/<Resource-Type>/<Action>. For Example: Microsoft.Purview/PolicyElements/Delete.

## Other responses

- `304` — Not Modified
- `default` — Error

---

[API](https://skmtc.net/azure/apis/purview-pds.md) · [All operations](https://skmtc.net/azure/apis/purview-pds/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/purview-pds/versions/07e6713018e8/schema)