---
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

## 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[]
    - `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_id` string — Filter by enumeration id
      - `only_dns` boolean — Query only dns FQDN records
      - `only_ip` boolean — Query only dns IP records
    - `body` string
    - `automatic_vuln_scans` boolean

## Other responses

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

## Changes

- **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
- **2024-04-19** `ba8a20839440` — 1 breaking, 32 info
  - the response's body type changed from `array` to `object` for status `200`
  - the endpoint scheme security `X-API-Key` was added to the API
  - api tag `enumerations` added
  - added the new optional `query` request parameter `enum_type`
  - …29 more
- **2024-01-31** `4f557b176ebd` — 1 info
  - endpoint added
- **2023-12-05** `5c3748c387f7` — 1 breaking
  - api path removed without deprecation

[Change 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.dev/projectdiscovery/apis/pdcp-api/revisions/c41cd7ae7718?raw)