GET /accounts/{account_id}/data-security/posture/findings/{finding_id}/instances
Lists all security finding instances for a given security finding.
Servers
- https://api.cloudflare.com/client/v4
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
finding_id |
String | Yes |
A base64-encoded ID identifying this Finding. |
account_id |
String | Yes |
Cloudflare account ID for the user making the request. |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
min_affliction_date |
String | No |
Filter to view findings that occurred on or after the affliction date. Can be a date-time in ISO 8601 format or an epoch timestamp. |
page |
Integer | No |
A page number within the paginated result set. |
max_affliction_date |
String | No |
Filter to view findings that occurred on or before the affliction date. Can be a date-time in ISO 8601 format or an epoch timestamp. |
order |
String | No |
Which field to use when ordering the Finding's instances. When ordering by 'remediation.status', only the most recent non-stale remediation job is considered. Stale jobs (created before the instance's affliction_date) are treated as having no status for ordering purposes. Valid values:
|
finding_instance_ids[] |
Array | No |
Filter finding instances by an array of finding instance IDs. Supports multiple comma-separated values. |
archived |
Boolean | No |
Archived |
direction |
String | No |
Direction to order results. Valid values:
|
asset_ids[] |
Array | No |
Filter finding instances by an array of asset IDs. Supports multiple comma-separated values. |
per_page |
Integer | No |
Number of results to return per page. |
search |
String | No |
A search term. |
cursor |
String | No |
A cursor for pagination. Obtained from the |
remediation_statuses[] |
Array | No |
Filter finding instances by most recent remediation job status. Supports multiple comma-separated values. Use 'none' to filter instances with no remediation jobs or instances where the most recent job is stale. Note: Stale jobs (created before the instance's affliction_date) are ignored for filtering purposes, but are still included in the 'remediations' array with stale=true. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.