---
title: Scans
---

[Skip to content](#_top)

[API Reference](https://developers.cloudflare.com/api/python)

[Cloudforce One](https://developers.cloudflare.com/api/python/resources/cloudforce_one)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# Scans

#### ScansResults

##### [Get the Latest Scan Result](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/scans/subresources/results/methods/get)

cloudforce\_one.scans.results.get(strconfig\_id, ResultGetParams\*\*kwargs) -> [ResultGetResponse](<https://developers.cloudflare.com/api/python/resources/cloudforce_one#(resource)%20cloudforce_one.scans.results%20%3E%20(model)%20result_get_response%20%3E%20(schema)>)

GET/accounts/{account\_id}/cloudforce-one/scans/results/{config\_id}

##### ModelsExpand Collapse

<details>

<summary>

class ScanResult: …

</summary>

number: Optional\[float]

<a href="#(resource)%20cloudforce_one.scans.results%20%3E%20(model)%20scan_result%20%3E%20(schema)%20%3E%20(property)%20number">Link to this property</a>

proto: Optional\[str]

<a href="#(resource)%20cloudforce_one.scans.results%20%3E%20(model)%20scan_result%20%3E%20(schema)%20%3E%20(property)%20proto">Link to this property</a>

status: Optional\[str]

<a href="#(resource)%20cloudforce_one.scans.results%20%3E%20(model)%20scan_result%20%3E%20(schema)%20%3E%20(property)%20status">Link to this property</a>

</details>

[Link to this property](<#(resource)%20cloudforce_one.scans.results%20%3E%20(model)%20scan_result%20%3E%20(schema)>)

<details>

<summary>

class ResultGetResponse: …

</summary>

<details>

<summary>

\_1\_1\_1\_1: List\[<a href="https://developers.cloudflare.com/api/python/resources/cloudforce_one#(resource)%20cloudforce_one.scans.results%20%3E%20(model)%20scan_result%20%3E%20(schema)">ScanResult</a>]

</summary>

number: Optional\[float]

<a href="#(resource)%20cloudforce_one.scans.results%20%3E%20(model)%20scan_result%20%3E%20(schema)%20%3E%20(property)%20number">Link to this property</a>

proto: Optional\[str]

<a href="#(resource)%20cloudforce_one.scans.results%20%3E%20(model)%20scan_result%20%3E%20(schema)%20%3E%20(property)%20proto">Link to this property</a>

status: Optional\[str]

<a href="#(resource)%20cloudforce_one.scans.results%20%3E%20(model)%20scan_result%20%3E%20(schema)%20%3E%20(property)%20status">Link to this property</a>

</details>

<a href="#(resource)%20cloudforce_one.scans.results%20%3E%20(model)%20result_get_response%20%3E%20(schema)%20%3E%20(property)%201.1.1.1">Link to this property</a>

</details>

[Link to this property](<#(resource)%20cloudforce_one.scans.results%20%3E%20(model)%20result_get_response%20%3E%20(schema)>)

#### ScansConfig

##### [List Scan Configs](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/scans/subresources/config/methods/list)

cloudforce\_one.scans.config.list(ConfigListParams\*\*kwargs) -> SyncSinglePage\[[ConfigListResponse](<https://developers.cloudflare.com/api/python/resources/cloudforce_one#(resource)%20cloudforce_one.scans.config%20%3E%20(model)%20config_list_response%20%3E%20(schema)>)]

GET/accounts/{account\_id}/cloudforce-one/scans/config

##### [Create a new Scan Config](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/scans/subresources/config/methods/create)

cloudforce\_one.scans.config.create(ConfigCreateParams\*\*kwargs) -> [ConfigCreateResponse](<https://developers.cloudflare.com/api/python/resources/cloudforce_one#(resource)%20cloudforce_one.scans.config%20%3E%20(model)%20config_create_response%20%3E%20(schema)>)

POST/accounts/{account\_id}/cloudforce-one/scans/config

##### [Update an existing Scan Config](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/scans/subresources/config/methods/edit)

cloudforce\_one.scans.config.edit(strconfig\_id, ConfigEditParams\*\*kwargs) -> [ConfigEditResponse](<https://developers.cloudflare.com/api/python/resources/cloudforce_one#(resource)%20cloudforce_one.scans.config%20%3E%20(model)%20config_edit_response%20%3E%20(schema)>)

PATCH/accounts/{account\_id}/cloudforce-one/scans/config/{config\_id}

##### [Delete a Scan Config](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/scans/subresources/config/methods/delete)

cloudforce\_one.scans.config.delete(strconfig\_id, ConfigDeleteParams\*\*kwargs) -> object

DELETE/accounts/{account\_id}/cloudforce-one/scans/config/{config\_id}

##### ModelsExpand Collapse

<details>

<summary>

class ConfigListResponse: …

</summary>

id: str

Defines the Config ID.

<a href="#(resource)%20cloudforce_one.scans.config%20%3E%20(model)%20config_list_response%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

account\_id: str

<a href="#(resource)%20cloudforce_one.scans.config%20%3E%20(model)%20config_list_response%20%3E%20(schema)%20%3E%20(property)%20account_id">Link to this property</a>

frequency: float

Defines the number of days between each scan (0 = One-off scan).

<a href="#(resource)%20cloudforce_one.scans.config%20%3E%20(model)%20config_list_response%20%3E%20(schema)%20%3E%20(property)%20frequency">Link to this property</a>

ips: List\[str]

Defines a list of IP addresses or CIDR blocks to scan. The maximum number of total IP addresses allowed is 5000.

<a href="#(resource)%20cloudforce_one.scans.config%20%3E%20(model)%20config_list_response%20%3E%20(schema)%20%3E%20(property)%20ips">Link to this property</a>

ports: List\[str]

Defines a list of ports to scan. Valid values are:“default”, “all”, or a comma-separated list of ports or range of ports (e.g. \[“1-80”, “443”]). “default” scans the 100 most commonly open ports.

<a href="#(resource)%20cloudforce_one.scans.config%20%3E%20(model)%20config_list_response%20%3E%20(schema)%20%3E%20(property)%20ports">Link to this property</a>

</details>

[Link to this property](<#(resource)%20cloudforce_one.scans.config%20%3E%20(model)%20config_list_response%20%3E%20(schema)>)

<details>

<summary>

class ConfigCreateResponse: …

</summary>

id: str

Defines the Config ID.

<a href="#(resource)%20cloudforce_one.scans.config%20%3E%20(model)%20config_create_response%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

account\_id: str

<a href="#(resource)%20cloudforce_one.scans.config%20%3E%20(model)%20config_create_response%20%3E%20(schema)%20%3E%20(property)%20account_id">Link to this property</a>

frequency: float

Defines the number of days between each scan (0 = One-off scan).

<a href="#(resource)%20cloudforce_one.scans.config%20%3E%20(model)%20config_create_response%20%3E%20(schema)%20%3E%20(property)%20frequency">Link to this property</a>

ips: List\[str]

Defines a list of IP addresses or CIDR blocks to scan. The maximum number of total IP addresses allowed is 5000.

<a href="#(resource)%20cloudforce_one.scans.config%20%3E%20(model)%20config_create_response%20%3E%20(schema)%20%3E%20(property)%20ips">Link to this property</a>

ports: List\[str]

Defines a list of ports to scan. Valid values are:“default”, “all”, or a comma-separated list of ports or range of ports (e.g. \[“1-80”, “443”]). “default” scans the 100 most commonly open ports.

<a href="#(resource)%20cloudforce_one.scans.config%20%3E%20(model)%20config_create_response%20%3E%20(schema)%20%3E%20(property)%20ports">Link to this property</a>

</details>

[Link to this property](<#(resource)%20cloudforce_one.scans.config%20%3E%20(model)%20config_create_response%20%3E%20(schema)>)

<details>

<summary>

class ConfigEditResponse: …

</summary>

id: str

Defines the Config ID.

<a href="#(resource)%20cloudforce_one.scans.config%20%3E%20(model)%20config_edit_response%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

account\_id: str

<a href="#(resource)%20cloudforce_one.scans.config%20%3E%20(model)%20config_edit_response%20%3E%20(schema)%20%3E%20(property)%20account_id">Link to this property</a>

frequency: float

Defines the number of days between each scan (0 = One-off scan).

<a href="#(resource)%20cloudforce_one.scans.config%20%3E%20(model)%20config_edit_response%20%3E%20(schema)%20%3E%20(property)%20frequency">Link to this property</a>

ips: List\[str]

Defines a list of IP addresses or CIDR blocks to scan. The maximum number of total IP addresses allowed is 5000.

<a href="#(resource)%20cloudforce_one.scans.config%20%3E%20(model)%20config_edit_response%20%3E%20(schema)%20%3E%20(property)%20ips">Link to this property</a>

ports: List\[str]

Defines a list of ports to scan. Valid values are:“default”, “all”, or a comma-separated list of ports or range of ports (e.g. \[“1-80”, “443”]). “default” scans the 100 most commonly open ports.

<a href="#(resource)%20cloudforce_one.scans.config%20%3E%20(model)%20config_edit_response%20%3E%20(schema)%20%3E%20(property)%20ports">Link to this property</a>

</details>

[Link to this property](<#(resource)%20cloudforce_one.scans.config%20%3E%20(model)%20config_edit_response%20%3E%20(schema)>)