---
title: "Get asset policy events"
method: GET
path: "/v1/asset/policy/{policy_id}/events"
---

# Get asset policy events

`GET /v1/asset/policy/{policy_id}/events`

## Request

- Base URL: `https://api.projectdiscovery.io`
- URL: `https://api.projectdiscovery.io/v1/asset/policy/{policy_id}/events`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/projectdiscovery/apis/pdcp-api/docs/v1/asset/policy/:policy_id/events/get.ts> (a function with typed inputs; its response is checked against the schema)

Get the execution history for a specific asset policy, including apply actions, alert deliveries, and errors.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Shared Response

- object
  - `data` object
    - `events` ActivityEvent[]
      - `id` string
      - `event_type` string, required: Event type (e.g., asset_policy_applied, asset_policy_processed, asset_policy_alert_sent)
      - `subject_type` string, required: Subject type (e.g., asset_policy)
      - `subject_id` string, required: Subject ID (policy ID)
      - `subject_name` string: Subject name (policy name)
      - `status` 'succeeded' | 'failed' | 'pending', required
      - `error_message` string
      - `channel` string: Notification channel (email, slack, etc.)
      - `destination` string: Notification destination (redacted)
      - `alert_config_id` string
      - `asset_policy_id` string
      - `created_at` string, date-time, required
      - `updated_at` string, date-time
      - `seen` boolean
      - `message_payload` object: Event metadata
  - `total` integer
  - `limit` integer
  - `offset` integer
  - `message` string

## Other responses

- `400`: Example response
- `401`: Example response
- `404`: Example response
- `500`: Example response
- `default`: Example response

## Changes

- **2026-03-06** `b69f036fb8ff`: 1 info
  - endpoint added
- **2023-12-05** `5c3748c387f7`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/projectdiscovery/apis/pdcp-api/changes/v1/asset/policy/:policy_id/events/get.md)

---

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