GET /accounts/{account_id}/data-security/posture/policies/logs
Returns a list of policy invocation logs for the given account, sourced from ClickHouse via Ready Analytics. Each entry represents one execution of a policy against a finding instance, including the actions (remediation jobs and webhooks) it dispatched.
Results are scoped to the requesting account's CASB integrations. The integration_id query parameter, when supplied, is intersected against the account's integration allowlist; values outside the allowlist are silently dropped.
Pagination is offset-based. The response does not include a total row count; clients should treat a result with fewer than per_page entries as the end of the list.
Servers
- https://api.cloudflare.com/client/v4
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
account_id |
String | Yes |
Cloudflare account ID for the user making the request. |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
page |
Integer | No |
A page number within the paginated result set. |
per_page |
Integer | No |
Number of results to return per page. |
until |
String | No |
Upper bound on the log entry timestamp. Accepts ISO 8601 / RFC3339 or epoch seconds. Defaults to the current time. Must be greater than or equal to |
since |
String | No |
Lower bound on the log entry timestamp. Accepts ISO 8601 / RFC3339 or epoch seconds. Defaults to 7 days before |
policy_name |
String | No |
Comma-separated list of policy display names to filter by. At most 100 values, each at most 255 characters. |
integration_id |
String | No |
Comma-separated list of CASB integration IDs to filter by. At most 100 values, each at most 128 characters. Values outside the account's tenancy allowlist are silently ignored. When omitted, results are scoped to the full allowlist. |
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.