--- title: "Get Enumeration List" method: GET path: "/v1/asset/enumerate" tags: ["enumerations"] --- # Get Enumeration List `GET /v1/asset/enumerate` Get enumeration list ## Query parameters - `offset` integer - `limit` integer - `search` string - `enum_type` string - `sort_asc` string - `sort_desc` string - `status` string - `time` 'last_day' | 'last_week' | 'last_month' | 'last_3_months' | 'last_6_months' | 'last_12_months' | 'all_time' - `start_date` string, date - `end_date` string, date - `custom_filter` string - `is_internal` boolean ## Headers - `X-Team-Id` string ## Response `200` Example response - object - `current_page` integer, required - `result_count` integer, required - `total_results` integer, required - `total_pages` integer, required - `data` EnumerateData[], required - `id` string, required - `name` string, required - `status` string, required - `failure_reason` string - `completed_at` string, date-time - `enumeration_time` string, duration - `enumeration_type` string - `enumeration_stats` EnumerationStats - `hosts` integer, required - `http` integer, required - `endpoints` integer, required - `ports` integer, required - `total_assets` integer, required - `total_asset_groups` integer - `created_at` string, date-time, required - `updated_at` string, date-time - `root_domains` string[] - `exclusions` string[] — Combined inclusion (prefixed with +) and exclusion patterns for discovery scope - `enrichment_hosts_count` integer - `is_rescan` boolean - `rescan_count` integer - `cloudlist_config_ids` string[] - `cloudlist_provider_name` string - `enumeration_time_elapsed` string - `total_assets` integer - `new_assets` integer - `domain_names` string[] - `schedule` EnumerationSchedule - `enumeration_id` string, required - `scan_frequency` string, required - `schedule_last_run` string, required - `schedule_next_run` string, required - `start_time` string, time - `hourly_frequency` integer - `custom_weekdays` integer[] — Array of integer denoting the weekdays on which the scan is supposed to run. 0-6 denoting Sunday-Saturday. - `is_public` boolean - `asset_group_filters` AssetFilters - `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. - `body` string - `agent_id` string - `agent_tags` string[] - `agent_networks` string[] - `agent_behavior` 'distribute' | 'mirror' - `agent_auto_discover` boolean - `automatic_vuln_scans` boolean - `is_internal` boolean ## Other responses - `400` — Example response - `401` — Example response - `403` — Example response - `500` — Example response - `default` — Example response ## Changes - **2026-07-13** `220f0adf9efd` — 1 info - added the optional property `data/items/asset_group_filters/not_seen_for_days` to the response with the `200` status - **2026-03-06** `b69f036fb8ff` — 1 warning, 1 info - removed the optional property `data/items/asset_group_filters/enumeration_id` from the response with the `200` status - added the optional property `data/items/asset_group_filters/enumeration_ids` to the response with the `200` status - **2025-11-18** `41ee26b930f3` — 8 info - added the new optional `query` request parameter `is_internal` - added the optional property `data/items/agent_auto_discover` to the response with the `200` status - added the optional property `data/items/agent_behavior` to the response with the `200` status - added the optional property `data/items/agent_id` to the response with the `200` status - …4 more - **2025-08-13** `c41cd7ae7718` — 9 info - added the new optional `query` request parameter `custom_filter` - added the new optional `query` request parameter `end_date` - added the new optional `query` request parameter `start_date` - added the new optional `query` request parameter `time` - …5 more - **2024-09-22** `407b73d9ce28` — 7 info - added the new optional `header` request parameter `X-Team-Id` - added the new optional `query` request parameter `sort_asc` - added the new optional `query` request parameter `sort_desc` - added the new optional `query` request parameter `status` - …3 more [Full history](https://skmtc.dev/projectdiscovery/apis/pdcp-api/changes/v1/asset/enumerate/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-service-production.skmtc.workers.dev/v1/apis/projectdiscovery/pdcp-api/revisions/220f0adf9efd/schema)