---
title: "Changes to Get Scan List"
method: GET
path: "/v1/scans"
---

# Changes to Get Scan List

`GET /v1/scans`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 24 revisions.

- **2025-11-18** `41ee26b930f3`: 6 info
- **2025-08-13** `c41cd7ae7718`: 1 info
- **2024-09-22** `407b73d9ce28`: 2 info
- **2024-04-19** `ba8a20839440`: 7 breaking, 2 warning, 26 info
- **2024-01-31** `4f557b176ebd`: 7 breaking, 12 warning, 40 info
- **2023-12-08** `5bcc3de1c2c5`: 1 info
- **2023-12-06** `35be9c1301b7`: 1 info
- **2023-12-05** `5c3748c387f7`: 17 breaking, 25 warning, 15 info

## Changes

- **2025-11-18** `41ee26b930f3`: 6 info
  - added the new optional `query` request parameter `is_internal`
  - 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
  - added the optional property `data/items/agent_networks` to the response with the `200` status
  - added the optional property `data/items/agent_tags` to the response with the `200` status
  - added the optional property `data/items/is_internal` to the response with the `200` status
- **2025-08-13** `c41cd7ae7718`: 1 info
  - added the optional property `data/items/is_automatic` to the response with the `200` status
- **2024-09-22** `407b73d9ce28`: 2 info
  - added the new optional `header` request parameter `X-Team-Id`
  - added the required property `data/items/total_result` to the response with the `200` status
- **2024-04-19** `ba8a20839440`: 7 breaking, 2 warning, 26 info
  - removed the media type `application/xml` for the response with the status `200`
  - removed the media type `application/xml` for the response with the status `400`
  - removed the media type `application/xml` for the response with the status `401`
  - removed the media type `application/xml` for the response with the status `500`
  - removed the required property `data` from the response with the `400` status
  - removed the required property `data` from the response with the `401` status
  - removed the required property `data` from the response with the `500` status
  - removed the optional property `data/items/scan_frequency` from the response with the `200` status
  - removed the optional property `data/items/schedule_last_run` from the response with the `200` status
  - added the new optional `query` request parameter `sort_asc`
  - added the new optional `query` request parameter `sort_desc`
  - added the non-success response with the status `499`
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `401` status
  - added the optional property `code` to the response with the `500` status
  - added the optional property `data/items/schedule` to the response with the `200` status
  - added the optional property `error` to the response with the `400` status
  - added the optional property `error` to the response with the `401` status
  - added the optional property `error` to the response with the `500` status
  - added the optional property `error_id` to the response with the `400` status
  - added the optional property `error_id` to the response with the `401` status
  - added the optional property `error_id` to the response with the `500` status
  - added the optional property `kind` to the response with the `400` status
  - added the optional property `kind` to the response with the `401` status
  - added the optional property `kind` to the response with the `500` status
  - added the optional property `param` to the response with the `400` status
  - added the optional property `param` to the response with the `401` status
  - added the optional property `param` to the response with the `500` status
  - added the optional property `status` to the response with the `400` status
  - added the optional property `status` to the response with the `401` status
  - added the optional property `status` to the response with the `500` status
  - added the required property `current_page` to the response with the `200` status
  - added the required property `result_count` to the response with the `200` status
  - added the required property `total_pages` to the response with the `200` status
  - added the required property `total_results` to the response with the `200` status
- **2024-01-31** `4f557b176ebd`: 7 breaking, 12 warning, 40 info
  - for the `query` request parameter `offset`, the type changed from `string` to `integer`
  - the `data/items/is_cloud` response's property type changed from `string` to `boolean` for status `200`
  - the `data/items/is_cloud` response's property type changed from `string` to `boolean` for status `401`
  - the `data/items/is_oss` response's property type changed from `string` to `boolean` for status `200`
  - the `data/items/is_oss` response's property type changed from `string` to `boolean` for status `401`
  - the `data/items/scan_frequency` response's property type changed from no type to `string` for status `200`
  - the `data/items/scan_frequency` response's property type changed from no type to `string` for status `401`
  - removed the optional property `data/items/severity/critical` from the response with the `200` status
  - removed the optional property `data/items/severity/critical` from the response with the `401` status
  - removed the optional property `data/items/severity/high` from the response with the `200` status
  - removed the optional property `data/items/severity/high` from the response with the `401` status
  - removed the optional property `data/items/severity/info` from the response with the `200` status
  - removed the optional property `data/items/severity/info` from the response with the `401` status
  - removed the optional property `data/items/severity/low` from the response with the `200` status
  - removed the optional property `data/items/severity/low` from the response with the `401` status
  - removed the optional property `data/items/severity/medium` from the response with the `200` status
  - removed the optional property `data/items/severity/medium` from the response with the `401` status
  - removed the optional property `data/items/severity/unknown` from the response with the `200` status
  - removed the optional property `data/items/severity/unknown` from the response with the `401` status
  - the `query` request parameter `limit` became optional
  - the `query` request parameter `offset` became optional
  - added the non-success response with the status `400`
  - added the non-success response with the status `500`
  - added the optional property `data/items/asset_ids` to the response with the `200` status
  - added the optional property `data/items/asset_ids` to the response with the `401` status
  - added the optional property `data/items/is_rescan` to the response with the `200` status
  - added the optional property `data/items/is_rescan` to the response with the `401` status
  - added the optional property `data/items/public_templates` to the response with the `200` status
  - added the optional property `data/items/public_templates` to the response with the `401` status
  - added the optional property `data/items/report_config_ids` to the response with the `200` status
  - added the optional property `data/items/report_config_ids` to the response with the `401` status
  - added the optional property `data/items/rescan_count` to the response with the `200` status
  - added the optional property `data/items/rescan_count` to the response with the `401` status
  - added the optional property `data/items/scan_config_ids` to the response with the `200` status
  - added the optional property `data/items/scan_config_ids` to the response with the `401` status
  - added the optional property `data/items/template_ids` to the response with the `200` status
  - added the optional property `data/items/template_ids` to the response with the `401` status
  - added the optional property `data/items/template_urls` to the response with the `200` status
  - added the optional property `data/items/template_urls` to the response with the `401` status
  - the response property `data/items/completed_at` became required for the status `200`
  - …19 more
- **2023-12-08** `5bcc3de1c2c5`: 1 info
  - for the `query` request parameter `offset`, the type was generalized from `integer` to `string`
- **2023-12-06** `35be9c1301b7`: 1 info
  - api tag `scans` added
- **2023-12-05** `5c3748c387f7`: 17 breaking, 25 warning, 15 info
  - the `query` request parameter `limit` became required
  - the `query` request parameter `offset` became required
  - the response property `data/items/completed_at` became optional for the status `200`
  - the response property `data/items/failure_reason` became optional for the status `200`
  - the response property `data/items/is_cloud` became optional for the status `200`
  - the response property `data/items/is_oss` became optional for the status `200`
  - the response property `data/items/scan_time_elapsed` became optional for the status `200`
  - the response property `data/items/updated_at` became optional for the status `200`
  - the response property `message` became optional for the status `200`
  - the response property `message` became optional for the status `401`
  - the `data/items/is_cloud` response's property type changed from `boolean` to `string` for status `200`
  - the `data/items/is_oss` response's property type changed from `boolean` to `string` for status `200`
  - removed the required property `current_page` from the response with the `200` status
  - removed the required property `data/items/total_result` from the response with the `200` status
  - removed the required property `result_count` from the response with the `200` status
  - removed the required property `total_pages` from the response with the `200` status
  - removed the required property `total_results` from the response with the `200` status
  - deleted the `header` request parameter `X-Team-Id`
  - deleted the `query` request parameter `is_internal`
  - deleted the `query` request parameter `sort_asc`
  - deleted the `query` request parameter `sort_desc`
  - removed the optional property `code` from the response with the `401` status
  - removed the optional property `data/items/agent_behavior` from the response with the `200` status
  - removed the optional property `data/items/agent_id` from the response with the `200` status
  - removed the optional property `data/items/agent_networks` from the response with the `200` status
  - removed the optional property `data/items/agent_tags` from the response with the `200` status
  - removed the optional property `data/items/asset_ids` from the response with the `200` status
  - removed the optional property `data/items/is_automatic` from the response with the `200` status
  - removed the optional property `data/items/is_internal` from the response with the `200` status
  - removed the optional property `data/items/is_rescan` from the response with the `200` status
  - removed the optional property `data/items/public_templates` from the response with the `200` status
  - removed the optional property `data/items/report_config_ids` from the response with the `200` status
  - removed the optional property `data/items/rescan_count` from the response with the `200` status
  - removed the optional property `data/items/scan_config_ids` from the response with the `200` status
  - removed the optional property `data/items/schedule` from the response with the `200` status
  - removed the optional property `data/items/template_ids` from the response with the `200` status
  - removed the optional property `data/items/template_urls` from the response with the `200` status
  - removed the optional property `error` from the response with the `401` status
  - removed the optional property `error_id` from the response with the `401` status
  - removed the optional property `kind` from the response with the `401` status
  - …17 more

---

[Operation](https://skmtc.dev/projectdiscovery/apis/pdcp-api/docs/v1/scans/get.md) - [API](https://skmtc.dev/projectdiscovery/apis/pdcp-api.md) - [Page](https://skmtc.dev/projectdiscovery/apis/pdcp-api/changes/v1/scans/get)
