get-findings
Retrieve summarized findings data from OnSecurity, optionally filtered by round ID or type, for clear client insights. Includes sorting, pagination, and custom field selection.
Instructions
Get all findings data from OnSecurity from client in a high level summary, only include the summary, not the raw data and be sure to present the data in a way that is easy to understand for the client. You can optionally filter findings by round_id. Note that there is no way to find the most common findings using this endpoint. You must use the get-blocks endpoint to find the most common findings.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fields | No | Optional comma-separated list of fields to return (e.g. 'id,name'). Use * as wildcard. | |
| filters | No | Optional additional filters in format {field: value} or {field-operator: value} where operator can be mt (more than), mte (more than equal), lt (less than), lte (less than equal), eq (equals, default) | |
| includes | No | Optional related data to include as comma-separated values (e.g. 'client,round,target_components') | |
| limit | No | Optional limit parameter for max results per page (e.g. 15) | |
| page | No | Optional page number to fetch (default: 1) | |
| round_id | No | Optional round ID to filter findings | |
| round_type | No | Optional round type to filter rounds, 1 = pentest round, 3 = scan round | |
| search | No | Optional search term to filter findings by matching text | |
| sort | No | Optional sort parameter in format 'field-direction'. Available values: name-asc, round_id-asc, created_at-asc, updated_at-asc, name-desc, round_id-desc, created_at-desc, updated_at-desc. Default: id-asc |