> ## Documentation Index > Fetch the complete documentation index at: https://docs.bevor.io/llms.txt > Use this file to discover all available pages before exploring further. # list findings > list findings using search parameters. Returns a paginated response. ## OpenAPI ````yaml /api-reference/security.json get /security/findings openapi: 3.1.2 info: title: Bevor Security API version: 1.0.0 servers: [] security: [] tags: - name: analysis description: Analyses, which own a lineage of versions and track a HEAD. - name: analysis version description: 'Versions of an analysis: creation, lineage, diffs, and pipeline runs.' - name: finding description: Findings on an analysis version, their staged edits, and comments. - name: remediation description: Remediations generated for findings. - name: summary description: Aggregated reporting over analyses, projects, and users. - name: chat description: Audit chat threads and messages. paths: /security/findings: get: tags: - finding summary: list findings description: list findings using search parameters. Returns a paginated response. parameters: - name: page in: query required: false schema: type: integer default: 0 - name: page_size in: query required: false schema: type: integer default: 50 - name: project_id in: query required: false schema: type: string nullable: true - name: project_slug in: query required: false schema: type: string nullable: true - name: user_id in: query required: false schema: type: string nullable: true - name: code_version_id in: query required: false schema: type: string nullable: true - name: analysis_ids in: query required: false schema: type: string nullable: true - name: type in: query required: false schema: type: string enum: - access_control - reentrancy - arithmetic - validation - logic - concurrency - economic - oracle - denial_of_service - upgradeability - data_exposure - cryptography nullable: true - name: level in: query required: false schema: type: string enum: - critical - high - medium - low nullable: true - name: is_acknowledged in: query required: false schema: type: boolean nullable: true - name: created_by_user_id in: query required: false schema: type: string nullable: true - name: operation in: query required: false schema: enum: - add - update - delete type: string nullable: true - name: order_by in: query required: false schema: type: string enum: - created_at - updated_at - level default: created_at - name: order in: query required: false schema: type: string enum: - desc - asc default: desc responses: '200': description: Successful Response content: application/json: schema: properties: results: items: $ref: '#/components/schemas/FindingSchema' title: Results type: array page: title: Page type: integer page_size: title: Page Size type: integer more: title: More type: boolean total_observations: title: Total Observations type: integer total_pages: title: Total Pages type: integer required: - page - page_size - more - total_observations - total_pages title: Pagination[FindingSchema] type: object '400': description: Error Response content: application/json: schema: $ref: '#/components/schemas/ApiError' security: - BearerAuth: [] components: schemas: FindingSchema: properties: version: $ref: '#/components/schemas/AnalysisVersionRef' created_at: format: date-time title: Created At type: string origin_finding_id: title: Origin Finding Id type: string is_acknowledged: title: Is Acknowledged type: boolean type: title: Type type: string level: enum: - critical - high - medium - low title: Level type: string name: title: Name type: string explanation: title: Explanation type: string recommendation: type: string nullable: true reference: type: string nullable: true source: title: Source type: string id: title: Id type: string node_id: title: Node Id type: string is_borrowed: title: Is Borrowed type: boolean location_id: type: string nullable: true created_by_user: $ref: '#/components/schemas/UserSchema' project_id: title: Project Id type: string project_slug: title: Project Slug type: string code_version_id: title: Code Version Id type: string operation: enum: - add - update - delete type: string nullable: true actions: $ref: '#/components/schemas/FindingActions' required: - version - created_at - origin_finding_id - is_acknowledged - type - level - name - explanation - source - id - node_id - is_borrowed - created_by_user - project_id - project_slug - code_version_id - actions title: FindingSchema type: object ApiError: properties: code: enum: - auth.session_expired - auth.session_revoked - auth.session_invalid - auth.user_does_not_exist - auth.invalid_team_membership - auth.unauthorized - auth.key_revoked - auth.key_invalid - auth.payment_required - auth.team_required - auth.invalid_permissions - error.not_found - error.invalid_scope - error.limit - error.entity_deleted - error.invalid_state - error.conflict - error.integrity - error.database - error.validation - error.server - analysis.entrypoint_failure - code.unsupported - code.node_invalid - code.conflict - app.rate_limit - payment.error - payment.failed title: Code type: string message: title: Message type: string required: - code - message title: ApiError type: object AnalysisVersionRef: properties: id: title: Id type: string analysis_id: title: Analysis Id type: string required: - id - analysis_id title: AnalysisVersionRef type: object UserSchema: properties: id: title: Id type: string is_self: title: Is Self type: boolean created_at: format: date-time title: Created At type: string username: title: Username type: string required: - id - is_self - created_at - username title: UserSchema type: object FindingActions: properties: can_edit: title: Can Edit type: boolean can_revert: title: Can Revert type: boolean can_delete: title: Can Delete type: boolean required: - can_edit - can_revert - can_delete title: FindingActions type: object securitySchemes: BearerAuth: type: http scheme: bearer description: API key in Bearer token format ````