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

# Get asset policy

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

Get a single asset policy by ID, including its conditions, action configuration, and execution metadata.

## Response `200`

OK

- object
  - `data` AssetPolicy
    - `id` string, required — Unique identifier for the asset policy
    - `name` string, required — Name of the asset policy
    - `policy_type` 'alert' | 'delete' | 'set_label' | 'remove_label', required — Type of action to perform when policy matches assets
    - `policies` AssetFilters, required
      - `is_tech` boolean — Return records that have technologies
      - `is_favicon` boolean — Return the records that have favicon
      - `is_new` boolean — Filter by new content
      - `labels` string — Filter by comma separated labels, e.g-> labels=p1,p2
      - `host` string — Filter by comma separated hosts, e.g-> host=p1,p2
      - `port` string — Filter by comma separated ports, e.g-> port=p1,p2
      - `status_code` string — Filter by comma separated status codes, e.g-> status_code=p1,p2
      - `content_length` string — Filter by comma separated content lengths, e.g-> content_length=p1,p2
      - `title` string — Filter by comma separated titles, e.g-> title=p1,p2
      - `domain` string[] — Filter by comma separated domain names, e.g-> domain=domain1.com,domain2.com
      - `cname` string — Filter by comma separated cnames, e.g-> cname=p1,p2
      - `technologies` string — Filter by comma separated technologies, e.g-> technologies=p1,p2
      - `ip` string — Filter by comma separated ips, e.g-> ip=p1,p2
      - `is_screenshot` boolean — Return the records with screenshots
      - `time` 'last_day' | 'last_week' | 'last_month' | 'last_3_months' | 'last_6_months' | 'last_12_months' | 'all_time'
      - `start_date` string, date — Filter by start date
      - `end_date` string, date — Filter by end date
      - `custom_filter` string — Filter by custom filter. Double encode the query string.
      - `search` string — Search on the content name
      - `enumeration_ids` string[] — Filter by enumeration ids
      - `only_dns` boolean — Query only dns FQDN records
      - `only_ip` boolean — Query only dns IP records
      - `not_seen_for_days` integer — Return assets that haven't been seen in the last N days. An asset is only included if a scan that covers it has run during that period without rediscovering it, so assets that simply haven't been rescanned recently are not matched.
    - `alerting_config_ids` string[] — List of alerting configuration IDs bound to this asset policy (required for alert type)
    - `labels` string[] — List of labels associated with this policy (used for set_label/remove_label types)
    - `enumeration_ids` string[] — Optional list of enumeration IDs to scope this policy to specific enumerations
    - `metadata` object — Additional metadata
    - `created_at` string, date-time, required — Creation timestamp
    - `updated_at` string, date-time, required — Last update timestamp
    - `last_executed_at` string, date-time — Timestamp of the last successful policy execution
    - `apply_to_existing` boolean — Whether this policy applies to existing matching assets in addition to future assets
  - `message` string

## Other responses

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

---

[API](https://skmtc.net/projectdiscovery/apis/pdcp-api.md) · [All operations](https://skmtc.net/projectdiscovery/apis/pdcp-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/projectdiscovery/pdcp-api/versions/220f0adf9efd/schema)