# Get company findings

This endpoint will return data and information about findings in the portfolio.

Endpoint: GET /v2/findings
Version: 2
Security: bearer

## Query parameters:

  - `limit` (number)
    Number of records to return in the response

  - `sortBy` (string)
    Name of the field to sort by
    Enum: "status", "asset_name", "test_name", "insert_ts", "update_ts"

  - `sortDirection` (string)
    The direction of the field sort specified by sort_by
    Enum: "ASC", "asc", "1", "DESC", "desc", "-1"

  - `next_token` (string)
    Token received from a previous request to obtain the next chunk of data

  - `fields` (string)
    Fields to include in response
    Enum: "id", "status", "severity", "asset_name", "category", "sub_category", "test_text", "test_name", "finding_text", "description", "insert_ts", "update_ts", "metadata", "cves"

  - `status` (array)
    Status of the finding(s)

  - `severity` (array)
    Severity of the finding(s)

  - `asset_name` (array)
    Asset of finding(s)

  - `id` (array)
    Id of the finding(s)

  - `sub_category` (array)
    Sub category of finding(s)

  - `segments` (array)
    Ids of segments of finding(s)

  - `test_name` (array)

## Response 200 fields (application/json):

  - `status` (string, required)
    Enum: "OPEN", "DONE"

  - `severity` (string, required)
    Enum: "LOW", "MEDIUM", "HIGH", "CRITICAL"

  - `id` (string, required)

  - `metadata` (object, required)

  - `cves` (array, required)

  - `asset_name` (string, required)

  - `category` (string, required)

  - `sub_category` (string, required)

  - `test_text` (string, required)

  - `finding_text` (string, required)

  - `description` (string, required)

  - `insert_ts` (string, required)

  - `update_ts` (string, required)

  - `test_name` (string, required)

  - `segments` (array, required)


## Response 401 fields

## Response 403 fields

## Response 429 fields