> ## Documentation Index
> Fetch the complete documentation index at: https://docs.projectdiscovery.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get asset policy events

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

## Example Request

```bash theme={null}
curl -X GET "https://api.projectdiscovery.io/v1/asset/policy/POLICY_ID/events?limit=20&offset=0" \
  -H "X-Api-Key: YOUR_API_KEY"
```


## OpenAPI

````yaml get /v1/asset/policy/{policy_id}/events
openapi: 3.1.0
info:
  title: PDCP API
  version: '1.0'
  summary: ProjectDiscovery Cloud Platform
  description: >-
    For more details, checkout
    https://docs.projectdiscovery.io/api-reference/editor/scan
servers:
  - url: https://api.projectdiscovery.io
    description: Production
  - url: https://api.dev.projectdiscovery.io
    description: Development
  - url: http://localhost:8085
    description: Localhost
security:
  - X-API-Key: []
paths:
  /v1/asset/policy/{policy_id}/events:
    parameters:
      - schema:
          type: string
        name: policy_id
        in: path
        required: true
        description: Unique identifier of the asset policy
    get:
      tags: []
      summary: Get asset policy events
      description: >-
        Get the execution history for a specific asset policy, including apply
        actions, alert deliveries, and errors.
      operationId: get-v1-asset-policy-policy_id-events
      parameters:
        - schema:
            type: integer
          in: query
          name: limit
          description: 'Maximum results per page (default: 50, max: 100)'
        - schema:
            type: integer
          in: query
          name: offset
          description: Number of items to skip for pagination
      responses:
        '200':
          description: Shared Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      events:
                        type: array
                        items:
                          $ref: '#/components/schemas/ActivityEvent'
                  total:
                    type: integer
                  limit:
                    type: integer
                  offset:
                    type: integer
                  message:
                    type: string
        '400':
          $ref: '#/components/responses/ErrorResponse'
        '401':
          $ref: '#/components/responses/ErrorResponse'
        '404':
          $ref: '#/components/responses/ErrorResponse'
        '500':
          $ref: '#/components/responses/ErrorResponse'
        default:
          $ref: '#/components/responses/ErrorResponse'
components:
  schemas:
    ActivityEvent:
      title: ActivityEvent
      type: object
      required:
        - event_type
        - subject_type
        - subject_id
        - status
        - created_at
      properties:
        id:
          type: string
        event_type:
          type: string
          description: >-
            Event type (e.g., asset_policy_applied, asset_policy_processed,
            asset_policy_alert_sent)
        subject_type:
          type: string
          description: Subject type (e.g., asset_policy)
        subject_id:
          type: string
          description: Subject ID (policy ID)
        subject_name:
          type: string
          description: Subject name (policy name)
        status:
          enum:
            - succeeded
            - failed
            - pending
        error_message:
          type: string
        channel:
          type: string
          description: Notification channel (email, slack, etc.)
        destination:
          type: string
          description: Notification destination (redacted)
        alert_config_id:
          type: string
        asset_policy_id:
          type: string
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        seen:
          type: boolean
        message_payload:
          type: object
          description: Event metadata
  responses:
    ErrorResponse:
      description: Example response
      content:
        application/json:
          schema:
            type: object
            required:
              - message
            properties:
              message:
                type: string
              kind:
                type: string
              code:
                type: string
              error:
                type: string
              error_id:
                type: string
              param:
                type: string
              status:
                type: integer
  securitySchemes:
    X-API-Key:
      name: X-API-Key
      type: apiKey
      in: header

````